Create-AADCFilterUsageLoc.ps1

[cmdletbinding()]
    Param(
            [Parameter(Mandatory=$TRUE,
                    HelpMessage="Required: Single AD FQDN Domain")]
                    [String]$ADFQDN,

            [Parameter(Mandatory=$TRUE,
                    HelpMessage="Optional: Rule Precedence Number")]
                    [Int]$Precedence,

            [Parameter(Mandatory=$False,
                    HelpMessage="Optional: Usage Location Code")]
                    [String]$UsageLocationCode = "US",

            [Parameter(Mandatory=$False,
                    HelpMessage="Optional: Business Code")]
                    [String]$BusinessAcronym
        )
    <#
    .Synopsis
        Supporting O365 Usage Location, this function creates an inbound Azure AD Connect
        Filter-Rule providing Azure AD Connect Synchronization for the AD attribute c (usage location)

    .Description
        If populating AD with the country code value, make sure you are using the appropriate
        ISO 3166-2 country code. - https://en.wikipedia.org/wiki/ISO_3166-2

    .Notes:
        Script Name: .Create-AADCFilterUsageLoc.ps1
        Author: Shwan May
        Email: shawn@yourdts.com
        Requires: Powershell V3 or greater

    .PARAMETER ADFQDN
        Mandatory - Specify AD Connector - FQDN
        To target a specific AD Connector, provide AD Connector FQDN - e.g. eus.acme.com

    .PARAMETER Precedence
        Mandatory - Specify a unique Filter-Rule Precedence Number
        Specify a precedence (integer) - e.g. 85

    .PARAMETER UsageLocation
        Optional - Specify Usage Location

    .PARAMETER BusinessAcronym
        Optional - Specify Business Acronym

    .EXAMPLE
        .Create-AADCFilterUsageLoc.ps1 -ADFQDN acme.com -Precedence 85 
        
        Creates AADC Filter-Rule - defines the United States as the default usage location and a
        Filter-Rule precedence of 85

    .EXAMPLE
        .Create-AADCFilterUsageLoc.ps1 -ADFQDN acme.com -Precedence 85 -UsageLocation GB
        
        Creates AADC Filter-Rule - defines the United Kingdom as the default usage location and a
        Filter-Rule precedence of 85

    .EXAMPLE
        .Create-AADCFilterUsageLoc.ps1 -ADFQDN acme.com -Precedence 25 -UsageLocation CO -BusinessAcronym ACME
        
        Creates AADC Filter-Rule - defines Colombia as the default usage location and a
        Filter-Rule precedence of 25 and appends business acronym to rule description
    #>

Clear-Host
Function Create-AADCRuleIn-UsageLoc {
       [cmdletbinding()]
            Param()

    # Checks if variable is object
    if (![string]::IsNullOrEmpty($ADFQDN))
        {
        # Acquires Filtered AD Connector (selects Identifier's GUID)
        $ADConnector = Get-ADSyncConnector | `
                Where-Object {$_.Type -eq 'AD' -and $_.name -eq $ADFQDN} | `
            Select-Object -ExpandProperty Identifier | `
            Select-Object -ExpandProperty guid

        if ($ADConnector -isnot [object])
            {
            Write-Warning "Could not locate specified AD Connector - $ADFQDN"
            exit
            }
        }
    else
        {
        # Acquires Filtered AD Connector (selects Identifier's GUID)
        $ADConnector = Get-ADSyncConnector | `
                Where-Object {$_.Type -eq 'AD'} | `
            Select-Object -ExpandProperty Identifier | `
            Select-Object -ExpandProperty guid
        }

    if (![string]::IsNullOrEmpty($BusinessAcronym))
        {$Acronym = " - " + $BusinessAcronym}

    if ($ADConnector -isnot [array])
        {
        # Defines AADC New Sync Rule Schema
        $syncRule = New-ADSyncRule -Name "In from AD - Custom Filter - User UsageLocation$Acronym - $UsageLocationCode" `
                -Identifier ([GUID]::NewGuid().Guid) `
                -Description 'User Join with UsageLocation from C' `
                -Direction 'Inbound' `
                -Precedence $Precedence `
                -PrecedenceAfter '00000000-0000-0000-0000-000000000000' `
                -PrecedenceBefore '00000000-0000-0000-0000-000000000000' `
                -SourceObjectType 'user' `
                -TargetObjectType 'person' `
                -Connector $ADConnector `
                -LinkType 'Join' `
                -SoftDeleteExpiryInterval 0 `
                -ImmutableTag ''

        # Defines AADC Attribute Flow
        $syncRule = Add-ADSyncAttributeFlowMapping `
            -SynchronizationRule $syncRule[0] `
            -Source @('c') `
            -Destination 'usageLocation' `
            -FlowType 'Expression' `
            -ValueMergeType 'Update' `
            -Expression ("IIF(IsNullOrEmpty([c])," + [char]34 + $UsageLocationCode + [char]34 + ",[c])")
        
        Try
            {
            # Creates new AADC Sync Rule
            Add-ADSyncRule -SynchronizationRule $syncRule[0] -ErrorAction Stop
            }
        Catch
            {
            # Writes Warning to Shell
            Write-Warning "There was a problem creating this AADC Filter-Rule!"
            Exit
            }
        Write-Host "Usage Location Inbound Filter-Rule Successfully Created. Perform a full AADC Synchronization." -ForegroundColor Yellow
        }
    else
        {Write-Warning "Please specify a single FQDN domain"}
}

Create-AADCRuleIn-UsageLoc