PowerShell Logo Small

Move-ADDirectoryServer



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.

SYNOPSIS

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

SYNTAX


Move-ADDirectoryServer [-Identity] <ADDirectoryServer> [-Site] <ADReplicationSite> [-AuthType <ADAuthType>] [-Credential <PSCredential>]
[-Server <String>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]] [<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 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/?LinkID=219321
Move-ADDirectoryServerOperationMasterRole

REMARKS

<

Examples


-------------------------- 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".