This is the built-in help made by Microsoft for the command 'Move-ADDirectoryServer', in PowerShell version 3 - as retrieved from
Windows version 'Microsoft Windows Server 2012 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.
Moves a directory server in Active Directory to a new site.
Move-ADDirectoryServer [-Identity] <ADDirectoryServer> [-Site] <ADReplicationSite> [-AuthType <ADAuthType>] [-Credential <PSCredential>]
[-Server <String>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<CommonParameters>]
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 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.
<
Online Version: http://go.microsoft.com/fwlink/?LinkID=219321
Move-ADDirectoryServerOperationMasterRole
<
-------------------------- EXAMPLE 1 --------------------------
C:\PS>Move-ADDirectoryServer -Identity "FABRIKAM-DC2" -Site "Branch-Office-Site"
Description
-----------
Move the domain controller "FABRIKAM-DC2" to the site "Branch-Office-Site".
-------------------------- EXAMPLE 2 --------------------------
C:\PS>Get-ADDomainController -Filter {IsReadOnly -eq $true} | Move-ADDirectoryServer -site "RODC-Site-Name"
Description
-----------
Move all Read Only Domain Controllers to the site "RODC-Site-Name".