Functions/Move-DryADComputer.ps1
|
# DryActiveDirectory is an AD config module for use with DryDeploy, or by itself. # # Copyright (C) 2021 Bjørn Henrik Formo (bjornhenrikformo@gmail.com) # LICENSE: https://raw.githubusercontent.com/bjoernf73/DryActiveDirectory/main/LICENSE # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 2 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License along # with this program; if not, write to the Free Software Foundation, Inc., # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Function Move-DryADComputer { [CmdletBinding(DefaultParameterSetName='Local')] Param ( [Parameter(Mandatory)] [String] $ComputerName, [Parameter(Mandatory)] [String] $TargetOU, [Parameter(HelpMessage="Only test, and return true or false")] [Switch] $Test, [Parameter(Mandatory,ParameterSetName='Remote', HelpMessage="PSSession to run the script blocks in")] [PSSession] $PSSession, [Parameter(Mandatory,ParameterSetName='Local', HelpMessage="For 'Local' sessions, specify the Domain Controller to use")] [String] $DomainController ) ol v @("Moving: '$ComputerName' to OU","$TargetOU") # Is the Object already in place?? Try { If ($PSCmdlet.ParameterSetName -eq 'Remote') { $Server = 'localhost' $ExecutionType = 'Remote' ol v @('Session Type','Remote') ol v @('Remoting to Domain Controller',$PSSession.ComputerName) } Else { $Server = $DomainController $ExecutionType = 'Local' ol v @('Session Type','Local') ol v @('Using Domain Controller',$Server) } $GetArgumentList = @($ComputerName,$TargetOU,$Server) $InvokeGetParams = @{ ScriptBlock = $DryAD_SB_MoveComputer_Get ArgumentList = $GetArgumentList } If ($ExecutionType -eq 'Remote') { $InvokeGetParams += @{ Session = $PSSession } } $GetResult = Invoke-Command @InvokeGetParams Switch ($GetResult) { $True { ol s "Computer is already in correct OU" ol v "'$ComputerName' is already in OU '$TargetOU'" } $False { ol v "'$ComputerName' is not in OU '$TargetOU' - trying to move it" } {$GetResult -is [System.Management.Automation.ErrorRecord]} { $PSCmdlet.ThrowTerminatingError($GetResult) } Default { Throw "An Error occured $($GetResult.ToString())" } } } Catch { $PSCmdlet.ThrowTerminatingError($_) } If ($Test) { Return $GetResult } ElseIf ($GetResult -eq $False) { Try { $SetArgumentList = @($ComputerName,$TargetOU,$Server) $InvokeSetParams = @{ ScriptBlock = $DryAD_SB_MoveComputer_Set ArgumentList = $SetArgumentList } If ($ExecutionType -eq 'Remote') { $InvokeSetParams += @{ Session = $PSSession } } $SetResult = Invoke-Command @InvokeSetParams Switch ($SetResult) { $True { ol s "Computer object was moved" ol v "'$ComputerName' was moved into OU '$TargetOU'" } {$SetResult -is [System.Management.Automation.ErrorRecord]} { $PSCmdlet.ThrowTerminatingError($SetResult) } Default { Throw "An Error occured $($SetResult.ToString())" } } } Catch { $PSCmdlet.ThrowTerminatingError($_) } } } |