PowerShell Logo Small

Move-ADDirectoryServer



This is the built-in help made by Microsoft for the command 'Move-ADDirectoryServer', in PowerShell version 5 - as retrieved from Windows version 'Microsoft Windows Server 2012 R2 Standard' PowerShell help files on 2016-06-23.

For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.

SYNOPSIS

Moves a directory server in Active Directory to a new site.

SYNTAX


Move-ADDirectoryServer [-Identity] <ADDirectoryServer> [-Site] <ADReplicationSite> [-AuthType {Negotiate | Basic}] [-Credential <PSCredential>] [-Server <String>] [-Confirm]
[-WhatIf] [<CommonParameters>]



Search powershellhelp.space

DESCRIPTION


The Move-ADDirectoryServer cmdlet moves a directory server in Active Directory to a new site within the same domain.


The Identity parameter specifies the directory server to move. You can specify a directory server object by one of the following values:

-- Name of the server object (name)
-- Distinguished Name (DN) of the NTDS Settings object
-- Distinguished Name (DN) of the server object that represents the directory server
-- GUID (objectGUID) of server object under the configuration partition
-- GUID (objectGUID) of NTDS settings object under the configuration partition


You can also set the Identity parameter to a directory server object variable such as $<localDirectoryServerObject>, or you can pass an object through the pipeline to the
Identity parameter. For example, you can use the Get-ADDomainController cmdlet to get a directory server object and then pass that object through the pipeline to the
Move-ADDirectoryServer cmdlet.


The Site parameter specifies the new site for the directory server. You can identify a site by its distinguished name (DN) or GUID.



<

RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/p/?linkid=291057
Move-ADDirectoryServerOperationMasterRole

REMARKS

<

Examples


-------------------------- EXAMPLE 1 --------------------------

PS C:\>Move-ADDirectoryServer -Identity "FABRIKAM-DC2" -Site "Branch-Office-Site"



This command moves the domain controller FABRIKAM-DC2 to the site Branch-Office-Site.




-------------------------- EXAMPLE 2 --------------------------

PS C:\>Get-ADDomainController -Filter {IsReadOnly -eq $true} | Move-ADDirectoryServer -site "RODC-Site-Name"



This command moves all Read Only Domain Controllers to the site RODC-Site-Name.