Public/Invoke-Sync365.ps1
|
<#
.DESCRIPTION This function allows for initiating an Azure AD Sync with a short alias. Saves time having to login to the Azure AD Synced server or type out the Full Invoke-Command cmdlet each time. .PARAMETER AzureSyncServer Specifies the server that has Azure Active Directory Synchronization installed .PARAMETER Policy Specify a sync policy other than delta .Example Invoke-Sync365 -AzureSyncServer server.domain.com Specify the Azure Sync Server for future use .Example Sync365 If the Azure Sync Server has been specified simply type the alias to initiate an azure sync .Example Sync365 -Policy Initial Specify a sync policy other than delta .Notes If attempting to run this on a server that doesn't have PSRemoting enabled and Azure AD Sync setup, then this function will fail. .Link https://github.com/TheTaylorLee/AdminToolbox #> Function Invoke-Sync365 { [Cmdletbinding()] [Alias('Sync365')] Param ( [Parameter(Mandatory = $false)][String]$AzureSyncServer, [Parameter(Mandatory = $false)][validateset ("delta", "initial")][String]$Policy = 'delta' ) if ($env:AzureSyncServer) { #Invoke Azure AD Sync Invoke-Command -ComputerName $env:AzureSyncServer -ScriptBlock { Start-ADSyncSyncCycle -PolicyType $policy } } else { Write-Warning "If you have not specified the Azure Sync Server to use, run this command again using the ""AzureSyncServer"" parameter first!" #Apply Environment variable to the current session $env:AzureSyncServer = $AzureSyncServer #Set Persistent Environment Variable [Environment]::SetEnvironmentVariable("AzureSyncServer", "$AzureSyncServer", "User") } } |