Move-ADObject
Synopsis
Description
The Identity parameter specifies the Active Directory object or container to move. You can identify an object or container by its distinguished name (DN) or GUID. You can also set the Identity parameter to an object variable such as $, or you can pass an object through the pipeline to the Identity parameter. For example, you can use the Get-ADObject cmdlet to retrieve an object and then pass the object through the pipeline to the Move-ADObject cmdlet. You can also use the Get-ADGroup, Get-ADUser, Get-ADComputer, Get-ADServiceAccount, Get-ADOrganizationalUnit and Get-ADFineGrainedPasswordPolicy cmdlets to get an object that you can pass through the pipeline to this cmdlet.
The TargetPath parameter must be specified. This parameter identifies the new location for the object or container.
Parameters
-AuthType
Specifies the authentication method to use. Possible values for this parameter include:
Required? false
Position? named
Default value Microsoft.ActiveDirectory.Management.AuthType.Negotiate
Accept pipeline input? false
Accept wildcard characters? false
-Credential <PSCredential>
Specifies the user account credentials to use to perform this task. The default credentials are the credentials of the currently logged on user unless the cmdlet is run from an Active Directory PowerShell provider drive. If the cmdlet is run from such a provider drive, the account associated with the drive is the default.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Identity <ADObject>
Specifies an Active Directory object by providing one of the following property values. The identifier in parentheses is the LDAP display name for the attribute.
Required? true
Position? 1
Default value
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-Partition <String>
Specifies the distinguished name of an Active Directory partition. The distinguished name must be one of the naming contexts on the current directory server. The cmdlet searches this partition to find the object defined by the Identity parameter.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-PassThru <SwitchParameter>
Returns the new or modified object. By default (i.e. if -PassThru is not specified), this cmdlet does not generate any output.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Server <String>
Specifies the Active Directory Domain Services instance to connect to, by providing one of the following values for a corresponding domain name or directory server. The service may be any of the following: Active Directory Lightweight Domain Services, Active Directory Domain Services or Active Directory Snapshot instance.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-TargetPath <String>
Specifies the new location for the object. This location must be the path to a container or organizational unit.
Required? true
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? false
-TargetServer <String>
Specifies the Active Directory instance to use by providing the following value for a corresponding domain name or directory server.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm <SwitchParameter>
Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value false
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf <SwitchParameter>
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? false
Position? named
Default value false
Accept pipeline input? false
Accept wildcard characters? falseSyntax
Move-ADObject [-WhatIf] [-Confirm] [-AuthType <ADAuthType>] [-Credential <PSCredential>] [-Identity] <ADObject> [-Partition <String>] [-PassThru] [-Server <String>] [-TargetPath] <String> [-TargetServer <String>] [<CommonParameters>]
This cmdlet does not work with an Active Directory Snapshot.
C:\PS>Move-ADObject -Identity “OU=ManagedGroups,DC=TOSSolution,DC=Com” -TargetPath “OU=Managed,DC=TOSSolution,DC=Com”
Moves the Organizational Unit ‘ManagedGroups’ to a new location. The OU ‘ManagedGroups’ must NOT be protected from accidental deletion for the successful move.
C:\PS>Move-ADObject “8d0bcc44-s213-4dd8-af5c-2c69960fbd47” -TargetPath “OU=Managed,DC=TOSSolution,DC=Com”
Moves the object identified by the specified GUID to the new location.
C:\PS>Move-ADObject “8d0bcc44-s213-4dd8-af5c-2c69960fbd47” -TargetPath “1c2ea8a8-a2w4-4a87-8190-0e8a166aee16”
Moves an object to a new location. Both the object and the target path are specified using GUIDs.
C:\PS>Move-ADObject -Identity “CN=Biju Tankkappan,OU=Accounting,DC=TOSSolution,DC=com” -TargetPath “OU=Accounting,DC=Delhi,DC=TOSSolution,DC=com” -TargetServer “server01.Delhi.TOSSolution.com”
Moves an object with DistinguishedName ‘CN=Biju Tankkappan,OU=Accounting,DC=TOSSolution,DC=com’ to a different domain.
C:\PS>Move-ADObject -Identity “CN=AccountLeads,DC=AppNC” -TargetPath “OU=AccountDeptOU,DC=AppNC” -server “TOSSolution-SRV1:60000”
Moves an object to a new location within an LDS instance.
Get-Command Move-ADObject
. Get-ADObject
. New-ADObject
. Remove-ADObject
. Rename-ADObject
. Restore-ADObject
. Set-ADObject
