Public/Enable-ADSIDomainControllerGlobalCatalog.ps1
|
function Enable-ADSIDomainControllerGlobalCatalog { <# .SYNOPSIS Function to enable the Global Catalog role on a Domain Controller .DESCRIPTION Function to enable the Global Catalog role on a Domain Controller .PARAMETER ComputerName Specifies the Domain Controller .PARAMETER Credential Specifies alternate credentials to use. Use Get-Credential to create proper credentials. .EXAMPLE Enable-ADSIDomainControllerGlobalCatalog -ComputerName dc1.ad.local Connects to remote domain controller dc1.ad.local using current credentials and enable the GC role. .EXAMPLE Enable-ADSIDomainControllerGlobalCatalog -ComputerName dc2.ad.local -Credential (Get-Credential SuperAdmin) Connects to remote domain controller dc2.ad.local using SuperAdmin credentials and enable the GC role. .NOTES Version History 1.0 Initial Version (Micky Balladelli) 1.1 Update (Francois-Xavier Cat) Rename from Enable-ADSIReplicaGC to Enable-ADSIDomainControllerGlobalCatalog Add New-ADSIDirectoryContext to take care of the Context Other minor modifications Authors Micky Balladelli balladelli.com micky@balladelli.com @mickyballadelli Francois-Xavier Cat lazywinadmin.com @lazywinadm github.com/lazywinadmin #> [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [string]$ComputerName, [Alias("RunAs")] [System.Management.Automation.PSCredential] [System.Management.Automation.Credential()] $Credential = [System.Management.Automation.PSCredential]::Empty ) PROCESS { TRY { $Context = New-ADSIDirectoryContext -ContextType 'DirectoryServer' @PSBoundParameters $DomainController = [System.DirectoryServices.ActiveDirectory.DomainController]::GetDomainController($context) IF ($DomainController.IsGlobalCatalog()) { Write-Verbose -Message "[Enable-ADSIDomainControllerGlobalCatalog][PROCESS] $($DomainController.name) is already a Global Catalog" } ELSE { Write-Verbose -Message "[Enable-ADSIDomainControllerGlobalCatalog][PROCESS] $($DomainController.name) Enabling Global Catalog ..." $DomainController.EnableGlobalCatalog() } Write-Verbose -Message "[Enable-ADSIDomainControllerGlobalCatalog][PROCESS] $($DomainController.name) Done." } CATCH { Write-Error -Message "[Enable-ADSIDomainControllerGlobalCatalog][PROCESS] Something wrong happened" $Error[0].Exception.Message } } } |