MSCommerce.psm1
################################ # Start: Internal use functions ################################ function Get-AccessTokenFromSessionData() { [CmdletBinding()] param( [Parameter(Mandatory = $true)] [System.Management.Automation.SessionState] $SessionState ) if ($null -eq $SessionState.PSVariable) { throw "unable to access SessionState. PSVariable, Please call Connect-MSCommerce before calling any other Powershell CmdLet for the MSCommerce Module" } $token = $SessionState.PSVariable.GetValue("token"); if ($null -eq $token) { throw "You must call the Connect-MSCommerce cmdlet before calling any other cmdlets" } return $token } function HandleError() { param( [Parameter(Mandatory = $true)] $ErrorContext, [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [string] $CustomErrorMessage ) $errorMessage = $ErrorContext.Exception.Message $errorDetails = $ErrorContext.ErrorDetails.Message if ($_.Exception.Response.StatusCode -eq 401) { Write-Error "Your credentials have expired. Please, call Connect-MSCommerce again to regain access to MSCommerce Module." return } write-error "$CustomErrorMessage, ErrorMessage - $errorMessage ErrorDetails - $errorDetails" } ################################ # End: Internal use functions ################################ ################################ # Start: Exported functions ################################ <# .SYNOPSIS Method to connect to MSCommerce with the credentials specified #> function Connect-MSCommerce() { [CmdletBinding()] param( [string] $ClientId = "3d5cffa9-04da-4657-8cab-c7f074657cad", [Uri] $RedirectUri = [uri] "http://localhost/m365/commerce", [string] $Resource = "aeb86249-8ea3-49e2-900b-54cc8e308f85/.default" #LicenseManager App Id ) if ($PSVersionTable.PSVersion.Major -gt 5){ Write-Error "Your PowerShell version is $($PSVersionTable.PSVersion.Major). Please use version 5 or below" return } # Create a public client application $publicClientApplication = New-MsalClientApplication -ClientId $ClientId # Acquire token interactively $authenticationResult = $publicClientApplication | Get-MsalToken -Scopes $Resource -RedirectUri $RedirectUri $token = $authenticationResult.AccessToken if ($null -eq $token) { Write-Error "Unable to establish connection" return } $sessionState = $PSCmdlet.SessionState $sessionState.PSVariable.Set("token", $token) Write-Host "Connection established successfully" } <# .SYNOPSIS Method to retrieve configurable policies #> function Get-MSCommercePolicies() { [CmdletBinding()] param( [Parameter(Mandatory = $false)] [string] $Token ) if (!$Token) { $Token = Get-AccessTokenFromSessionData -SessionState $PSCmdlet.SessionState } $correlationId = New-Guid $baseUri = "https://licensing.m365.microsoft.com" $restPath = "$baseUri/v1.0/policies" try { $response = Invoke-RestMethod ` -Method GET ` -Uri $restPath ` -Headers @{ "x-ms-correlation-id" = $correlationId "Authorization" = "Bearer $($Token)" } foreach ($policy in $response.items) { New-Object PSObject -Property @{ PolicyId = $policy.id Description = $policy.description DefaultValue = $policy.defaultValue } } } catch { HandleError -ErrorContext $_ -CustomErrorMessage "Failed to retrieve policies" } } <# .SYNOPSIS Method to retrieve a description of the specified policy #> function Get-MSCommercePolicy() { [CmdletBinding()] param( [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [string] $PolicyId, [Parameter(Mandatory = $false)] [string] $Token ) if (!$Token) { $Token = Get-AccessTokenFromSessionData -SessionState $PSCmdlet.SessionState } $correlationId = New-Guid $baseUri = "https://licensing.m365.microsoft.com" $restPath = "$baseUri/v1.0/policies/$PolicyId" try { $response = Invoke-RestMethod ` -Method GET ` -Uri $restPath ` -Headers @{ "x-ms-correlation-id" = $correlationId "Authorization" = "Bearer $($Token)" } New-Object PSObject -Property @{ PolicyId = $response.id Description = $response.description DefaultValue = $response.defaultValue } } catch { HandleError -ErrorContext $_ -CustomErrorMessage "Failed to retrieve policy with PolicyId '$PolicyId'" } } <# .SYNOPSIS Method to retrieve applicable products for the specified policy and their current settings #> function Get-MSCommerceProductPolicies() { [CmdletBinding()] param( [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [string] $PolicyId, [Parameter(Mandatory = $false)] [string] $Scope, [Parameter(Mandatory = $false)] [string] $Token ) if (!$Token) { $Token = Get-AccessTokenFromSessionData -SessionState $PSCmdlet.SessionState } $correlationId = New-Guid $baseUri = "https://licensing.m365.microsoft.com" $query = "scope=product" if($false -eq [string]::IsNullOrWhiteSpace($Scope)){ $query = "scope=$Scope" } $restPath = "$baseUri/v1.0/policies/$PolicyId/products" if($false -eq [string]::IsNullOrWhiteSpace($query)){ $restPath += "?$query" } try { $response = Invoke-RestMethod ` -Method GET ` -Uri $restPath ` -Headers @{ "x-ms-correlation-id" = $correlationId "Authorization" = "Bearer $($Token)" } foreach ($product in $response.items) { $properties = @{} $properties.Add("PolicyId", $product.policyId) $properties.Add("PolicyValue", $product.policyValue) if ($product.scope -eq "product") { $properties.Add("ProductName", $product.productName) $properties.Add("ProductId", $product.productId) } else { $properties.Add("ScopeId", $product.scopeId) $properties.Add("ScopeValue", $product.scopeValue) $properties.Add("Scope", $product.scope) } New-Object PSObject -Property $properties } } catch { HandleError -ErrorContext $_ -CustomErrorMessage "Failed to retrieve product policy with PolicyId '$PolicyId'" } } <# .SYNOPSIS Method to retrieve the current setting for the policy for the specified product #> function Get-MSCommerceProductPolicy() { [CmdletBinding(DefaultParameterSetName = "Product")] param( [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [string] $PolicyId, [Parameter(Mandatory = $true, ParameterSetName = "Product")] [ValidateNotNullOrEmpty()] [string] $ProductId, [Parameter(Mandatory = $true, ParameterSetName = "OfferType")] [ValidateNotNullOrEmpty()] [string] $OfferType, [Parameter(Mandatory = $false)] [string] $Token ) if (!$Token) { $Token = Get-AccessTokenFromSessionData -SessionState $PSCmdlet.SessionState } $correlationId = New-Guid $baseUri = "https://licensing.m365.microsoft.com" $restPath = "$baseUri/v1.0/policies/$PolicyId" if ($PSBoundParameters.ContainsKey("OfferType")) { $restPath += "/offerTypes/$OfferType" } else { $restPath += "/products/$ProductId" } try { $response = Invoke-RestMethod ` -Method GET ` -Uri $restPath ` -Headers @{ "x-ms-correlation-id" = $correlationId "Authorization" = "Bearer $($Token)" } $properties = @{} $properties.Add("PolicyId", $response.policyId) $properties.Add("PolicyValue", $response.policyValue) if ($PSBoundParameters.ContainsKey("ProductId")) { $properties.Add("ProductName", $response.productName) $properties.Add("ProductId", $response.productId) } else { $properties.Add("Scope", $response.scope) $properties.Add("ScopeValue", $response.scopeValue) $properties.Add("ScopeId", $response.scopeId) } New-Object PSObject -Property $properties } catch { HandleError -ErrorContext $_ -CustomErrorMessage "Failed to retrieve product policy with PolicyId '$PolicyId' ProductId '$ProductId'" } } <# .SYNOPSIS Method to modify the current setting for the policy for the specified product #> function Update-MSCommerceProductPolicy() { [CmdletBinding(SupportsShouldProcess, ConfirmImpact='Medium', DefaultParameterSetName = "ProductEnum")] param( [Parameter(Mandatory = $true)] [ValidateNotNullOrEmpty()] [string] $PolicyId, [Parameter(Mandatory = $true, ParameterSetName = "ProductToggle")] [Parameter(Mandatory = $true, ParameterSetName = "ProductEnum")] [ValidateNotNullOrEmpty()] [string] $ProductId, [Parameter(Mandatory = $true, ParameterSetName = "OfferTypeToggle")] [Parameter(Mandatory = $true, ParameterSetName = "OfferTypeEnum")] [string] $OfferType, [Parameter(Mandatory = $true, ParameterSetName = "ProductToggle")] [Parameter(Mandatory = $true, ParameterSetName = "OfferTypeToggle")] [ValidateNotNullOrEmpty()] [string] $Enabled, [Parameter(Mandatory = $true, ParameterSetName = "ProductEnum")] [Parameter(Mandatory = $true, ParameterSetName = "OfferTypeEnum")] [ValidateSet("Enabled", "Disabled", "OnlyTrialsWithoutPaymentMethod")] [string] $Value, [Parameter(Mandatory = $false)] [string] $Token ) if ($PSBoundParameters.ContainsKey("Enabled")) { if ("True" -ne $Enabled -and "False" -ne $Enabled) { Write-Error "Value of `$Enabled must be one of the following: `$True, `$true, `$False, `$false" return } } if (!$Token) { $Token = Get-AccessTokenFromSessionData -SessionState $PSCmdlet.SessionState } $correlationId = New-Guid $baseUri = "https://licensing.m365.microsoft.com" $restPath = "$baseUri/v1.0/policies/$PolicyId" if ($PSBoundParameters.ContainsKey("OfferType")) { $restPath += "/offerTypes/$OfferType" } else{ $restPath += "/products/$ProductId" } if ($PSBoundParameters.ContainsKey("Enabled")) { $policyValue = if ("True" -eq $Enabled -or "true" -eq $Enabled) {"Enabled"} else {"Disabled"} } else { $policyValue = $Value } $body = @{ policyValue = $policyValue } if ($False -eq $PSCmdlet.ShouldProcess("ShouldProcess?")) { Write-Host "Updating product policy aborted" return } try { $response = Invoke-RestMethod ` -Method PUT ` -Uri $restPath ` -Body ($body | ConvertTo-Json)` -ContentType 'application/json' ` -Headers @{ "x-ms-correlation-id" = $correlationId "Authorization" = "Bearer $($Token)" } Write-Host "Update policy product success" $properties = @{} $properties.Add("PolicyId", $response.policyId) $properties.Add("PolicyValue", $response.policyValue) if ($PSBoundParameters.ContainsKey("ProductId")) { $properties.Add("ProductName", $response.productName) $properties.Add("ProductId", $response.productId) } else { $properties.Add("Scope", $response.scope) $properties.Add("ScopeValue", $response.scopeValue) $properties.Add("ScopeId", $response.scopeId) } return New-Object PSObject -Property $properties } catch { HandleError -ErrorContext $_ -CustomErrorMessage "Failed to update product policy" } } ################################ # End: Exported functions ################################ Write-Host "MSCommerce module loaded" # SIG # Begin signature block # MIIoLQYJKoZIhvcNAQcCoIIoHjCCKBoCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCeQtYoGIcNhvbA # 8EyBjRTX9+XI30gLHDVg3Ni98+lN/aCCDXYwggX0MIID3KADAgECAhMzAAADrzBA # DkyjTQVBAAAAAAOvMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p # bmcgUENBIDIwMTEwHhcNMjMxMTE2MTkwOTAwWhcNMjQxMTE0MTkwOTAwWjB0MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB # AQDOS8s1ra6f0YGtg0OhEaQa/t3Q+q1MEHhWJhqQVuO5amYXQpy8MDPNoJYk+FWA # hePP5LxwcSge5aen+f5Q6WNPd6EDxGzotvVpNi5ve0H97S3F7C/axDfKxyNh21MG # 0W8Sb0vxi/vorcLHOL9i+t2D6yvvDzLlEefUCbQV/zGCBjXGlYJcUj6RAzXyeNAN # xSpKXAGd7Fh+ocGHPPphcD9LQTOJgG7Y7aYztHqBLJiQQ4eAgZNU4ac6+8LnEGAL # go1ydC5BJEuJQjYKbNTy959HrKSu7LO3Ws0w8jw6pYdC1IMpdTkk2puTgY2PDNzB # tLM4evG7FYer3WX+8t1UMYNTAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE # AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQURxxxNPIEPGSO8kqz+bgCAQWGXsEw # RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW # MBQGA1UEBRMNMjMwMDEyKzUwMTgyNjAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci # tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG # CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu # Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0 # MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAISxFt/zR2frTFPB45Yd # mhZpB2nNJoOoi+qlgcTlnO4QwlYN1w/vYwbDy/oFJolD5r6FMJd0RGcgEM8q9TgQ # 2OC7gQEmhweVJ7yuKJlQBH7P7Pg5RiqgV3cSonJ+OM4kFHbP3gPLiyzssSQdRuPY # 1mIWoGg9i7Y4ZC8ST7WhpSyc0pns2XsUe1XsIjaUcGu7zd7gg97eCUiLRdVklPmp # XobH9CEAWakRUGNICYN2AgjhRTC4j3KJfqMkU04R6Toyh4/Toswm1uoDcGr5laYn # TfcX3u5WnJqJLhuPe8Uj9kGAOcyo0O1mNwDa+LhFEzB6CB32+wfJMumfr6degvLT # e8x55urQLeTjimBQgS49BSUkhFN7ois3cZyNpnrMca5AZaC7pLI72vuqSsSlLalG # OcZmPHZGYJqZ0BacN274OZ80Q8B11iNokns9Od348bMb5Z4fihxaBWebl8kWEi2O # PvQImOAeq3nt7UWJBzJYLAGEpfasaA3ZQgIcEXdD+uwo6ymMzDY6UamFOfYqYWXk # ntxDGu7ngD2ugKUuccYKJJRiiz+LAUcj90BVcSHRLQop9N8zoALr/1sJuwPrVAtx # HNEgSW+AKBqIxYWM4Ev32l6agSUAezLMbq5f3d8x9qzT031jMDT+sUAoCw0M5wVt # CUQcqINPuYjbS1WgJyZIiEkBMIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq # hkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x # EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv # bjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5 # IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEwOTA5WjB+MQswCQYDVQQG # EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG # A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQg # Q29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC # CgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+laUKq4BjgaBEm6f8MMHt03 # a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc6Whe0t+bU7IKLMOv2akr # rnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4Ddato88tt8zpcoRb0Rrrg # OGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+lD3v++MrWhAfTVYoonpy # 4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nkkDstrjNYxbc+/jLTswM9 # sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6A4aN91/w0FK/jJSHvMAh # dCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmdX4jiJV3TIUs+UsS1Vz8k # A/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL5zmhD+kjSbwYuER8ReTB # w3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zdsGbiwZeBe+3W7UvnSSmn # Eyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3T8HhhUSJxAlMxdSlQy90 # lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS4NaIjAsCAwEAAaOCAe0w # ggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRIbmTlUAXTgqoXNzcitW2o # ynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYD # VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBDuRQFTuHqp8cx0SOJNDBa # BgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2Ny # bC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3JsMF4GCCsG # AQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3dy5taWNyb3NvZnQuY29t # L3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3J0MIGfBgNV # HSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEFBQcCARYzaHR0cDovL3d3 # dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1hcnljcHMuaHRtMEAGCCsG # AQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkAYwB5AF8AcwB0AGEAdABl # AG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn8oalmOBUeRou09h0ZyKb # C5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7v0epo/Np22O/IjWll11l # hJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0bpdS1HXeUOeLpZMlEPXh6 # I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/KmtYSWMfCWluWpiW5IP0 # wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvyCInWH8MyGOLwxS3OW560 # STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBpmLJZiWhub6e3dMNABQam # ASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJihsMdYzaXht/a8/jyFqGa # J+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYbBL7fQccOKO7eZS/sl/ah # XJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbSoqKfenoi+kiVH6v7RyOA # 9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sLgOppO6/8MO0ETI7f33Vt # Y5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtXcVZOSEXAQsmbdlsKgEhr # /Xmfwb1tbWrJUnMTDXpQzTGCGg0wghoJAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp # Z25pbmcgUENBIDIwMTECEzMAAAOvMEAOTKNNBUEAAAAAA68wDQYJYIZIAWUDBAIB # BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO # MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIL2ZTuvLv/2wonsrZfNaMwXy # pSmrFctNA3buNDN0pVYpMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A # cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB # BQAEggEAx4oeRTwXZq3WZRWH9e9V/sM2BfkcUwgawVzqmub8x4xm2FTlLJXh1uxh # 0Q6zTjAippydD0g5//fTTiTZkm1ryjQLOg2wantuVxeKJQzRnibWYtpzN6+FBfFa # 7hhX13kqwcJVZ+nVpZs4Dp8mpl1KGNl8UKnmy7NcnL9wsw5ae6F4PJPtWen0SPIS # OOOYBF17CYp739w36pU4YgS7eUX/9japzbFUktySZYovnTpN+CcIgSyy//Q6jCri # BHkNRPrC8D41bk5V0fLnRPp5QPw2Q7C5ejlxBynrJPNDZcLhhTqhV+IYUub66D9q # hngcVQtsUQrq9nNZ//+evHKahcxmbKGCF5cwgheTBgorBgEEAYI3AwMBMYIXgzCC # F38GCSqGSIb3DQEHAqCCF3AwghdsAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFSBgsq # hkiG9w0BCRABBKCCAUEEggE9MIIBOQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl # AwQCAQUABCCGIY75fPrHOJ0meda0u2/McRqPWuoTO8MfH4seY3PfhwIGZfLp3ONp # GBMyMDI0MDMyODIwNTcwNS4zMzhaMASAAgH0oIHRpIHOMIHLMQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1l # cmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046OTIwMC0w # NUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2Wg # ghHtMIIHIDCCBQigAwIBAgITMwAAAecujy+TC08b6QABAAAB5zANBgkqhkiG9w0B # AQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE # BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYD # VQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAeFw0yMzEyMDYxODQ1 # MTlaFw0yNTAzMDUxODQ1MTlaMIHLMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2Fz # aGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv # cnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25z # MScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046OTIwMC0wNUUwLUQ5NDcxJTAjBgNV # BAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggIiMA0GCSqGSIb3DQEB # AQUAA4ICDwAwggIKAoICAQDCV58v4IuQ659XPM1DtaWMv9/HRUC5kdiEF89YBP6/ # Rn7kjqMkZ5ESemf5Eli4CLtQVSefRpF1j7S5LLKisMWOGRaLcaVbGTfcmI1vMRJ1 # tzMwCNIoCq/vy8WH8QdV1B/Ab5sK+Q9yIvzGw47TfXPE8RlrauwK/e+nWnwMt060 # akEZiJJz1Vh1LhSYKaiP9Z23EZmGETCWigkKbcuAnhvh3yrMa89uBfaeHQZEHGQq # dskM48EBcWSWdpiSSBiAxyhHUkbknl9PPztB/SUxzRZjUzWHg9bf1mqZ0cIiAWC0 # EjK7ONhlQfKSRHVLKLNPpl3/+UL4Xjc0Yvdqc88gOLUr/84T9/xK5r82ulvRp2A8 # /ar9cG4W7650uKaAxRAmgL4hKgIX5/0aIAsbyqJOa6OIGSF9a+DfXl1LpQPNKR79 # 2scF7tjD5WqwIuifS9YUiHMvRLjjKk0SSCV/mpXC0BoPkk5asfxrrJbCsJePHSOE # blpJzRmzaP6OMXwRcrb7TXFQOsTkKuqkWvvYIPvVzC68UM+MskLPld1eqdOOMK7S # bbf2tGSZf3+iOwWQMcWXB9gw5gK3AIYK08WkJJuyzPqfitgubdRCmYr9CVsNOuW+ # wHDYGhciJDF2LkrjkFUjUcXSIJd9f2ssYitZ9CurGV74BQcfrxjvk1L8jvtN7mul # IwIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFM/+4JiAnzY4dpEf/Zlrh1K73o9YMB8G # A1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8GA1UdHwRYMFYwVKBSoFCG # Tmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY3Jvc29mdCUy # MFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBsBggrBgEFBQcBAQRgMF4w # XAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY2Vy # dHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3J0MAwG # A1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgwDgYDVR0PAQH/BAQD # AgeAMA0GCSqGSIb3DQEBCwUAA4ICAQB0ofDbk+llWi1cC6nsfie5Jtp09o6b6ARC # pvtDPq2KFP+hi+UNNP7LGciKuckqXCmBTFIhfBeGSxvk6ycokdQr3815pEOaYWTn # HvQ0+8hKy86r1F4rfBu4oHB5cTy08T4ohrG/OYG/B/gNnz0Ol6v7u/qEjz48zXZ6 # ZlxKGyZwKmKZWaBd2DYEwzKpdLkBxs6A6enWZR0jY+q5FdbV45ghGTKgSr5ECAOn # LD4njJwfjIq0mRZWwDZQoXtJSaVHSu2lHQL3YHEFikunbUTJfNfBDLL7Gv+sTmRi # DZky5OAxoLG2gaTfuiFbfpmSfPcgl5COUzfMQnzpKfX6+FkI0QQNvuPpWsDU8sR+ # uni2VmDo7rmqJrom4ihgVNdLaMfNUqvBL5ZiSK1zmaELBJ9a+YOjE5pmSarW5sGb # n7iVkF2W9JQIOH6tGWLFJS5Hs36zahkoHh8iD963LeGjZqkFusKaUW72yMj/yxTe # GEDOoIr35kwXxr1Uu+zkur2y+FuNY0oZjppzp95AW1lehP0xaO+oBV1XfvaCur/B # 5PVAp2xzrosMEUcAwpJpio+VYfIufGj7meXcGQYWA8Umr8K6Auo+Jlj8IeFS6lSv # KhqQpmdBzAMGqPOQKt1Ow3ZXxehK7vAiim3ZiALlM0K546k0sZrxdZPgpmz7O8w9 # gHLuyZAQezCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkAAAAAABUwDQYJKoZI # hvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # MjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhvcml0eSAy # MDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVowfDELMAkGA1UEBhMC # VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV # BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp # bWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoIC # AQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX9gF/bErg4r25Phdg # M/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1qUoNEt6aORmsHFPPF # dvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8dq6z2Nr41JmTamDu6 # GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byNpOORj7I5LFGc6XBp # Dco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2krnopN6zL64NF50Zu # yjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4dPf0gz3N9QZpGdc3E # XzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgSUei/BQOj0XOmTTd0 # lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8QmguEOqEUUbi0b1q # GFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6CmgyFdXzB0kZSU2LlQ # +QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzFER1y7435UsSFF5PA # PBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQIDAQABo4IB3TCCAdkw # EgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQUKqdS/mTEmr6CkTxG # NSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMFwGA1UdIARV # MFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0dHA6Ly93d3cubWlj # cm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0bTATBgNVHSUEDDAK # BggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMC # AYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbLj+iiXGJo0T2UkFvX # zpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20v # cGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcmwwWgYI # KwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNydDANBgkqhkiG # 9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwUtj5OR2R4sQaTlz0x # M7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN3Zi6th542DYunKmC # VgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU5HhTdSRXud2f8449 # xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5KYnDvBewVIVCs/wM # nosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGyqVvfSaN0DLzskYDS # PeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB62FD+CljdQDzHVG2d # Y3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltEAY5aGZFrDZ+kKNxn # GSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFpAUR+fKFhbHP+Crvs # QWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcdFYmNcP7ntdAoGokL # jzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRbatGePu1+oDEzfbzL # 6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQdVTNYs6FwZvKhggNQ # MIICOAIBATCB+aGB0aSBzjCByzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp # bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw # b3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEn # MCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjkyMDAtMDVFMC1EOTQ3MSUwIwYDVQQD # ExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQCz # cgTnGasSwe/dru+cPe1NF/vwQ6CBgzCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w # IFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA6a/a+TAiGA8yMDI0MDMyODEyMDMw # NVoYDzIwMjQwMzI5MTIwMzA1WjB3MD0GCisGAQQBhFkKBAExLzAtMAoCBQDpr9r5 # AgEAMAoCAQACAivRAgH/MAcCAQACAhNDMAoCBQDpsSx5AgEAMDYGCisGAQQBhFkK # BAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMHoSChCjAIAgEAAgMBhqAwDQYJ # KoZIhvcNAQELBQADggEBAFD1z+yNoG68CwlP0P6jJ4xi5XMIvqDte+oZ2TSo4RoL # KwKZmRmW/mBIS7V5vpJlNGtR+CBienBvvfjhh9Xgsqd57aqfsXD4r3VIdJw0kqBI # Xj3w4jaShvvjxP67HLtwtOdguXfeswbw/qsYSSkzvEUiKAgnxfwdb5K2+cVatUZ8 # byXu078D51/02RzcHprpY85v2Am2GGQcim2oIDt4w+hW+ebFkSNGZe0FH9pZk3va # 2S9cm/CZkel2vM+4kAu0aYhASAHil6+YXDd2qMsjqFv4HYf0Y5vA74iJJPsjoH0r # IEhIQ7aaI/w0c6bF9tTdBRHXCEsWOJ4XCRZRFmhSR3sxggQNMIIECQIBATCBkzB8 # MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk # bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1N # aWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAecujy+TC08b6QABAAAB # 5zANBglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkDMQ0GCyqGSIb3DQEJEAEE # MC8GCSqGSIb3DQEJBDEiBCAKtaU6NPdjLpKN3raAI4XwgErLiLtO2GkGi/7HEAwM # HDCB+gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0EIOU2XQ12aob9DeDFXM9UFHeE # X74Fv0ABvQMG7qC51nOtMIGYMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgT # Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m # dCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENB # IDIwMTACEzMAAAHnLo8vkwtPG+kAAQAAAecwIgQgZ0S7aswJ2tR5kn9rKScG8T36 # 7jpJP2Y5iFizESWBoU8wDQYJKoZIhvcNAQELBQAEggIACdNULzgmYBrvE5+gvMBB # 0cyQbYjqW7ljMWtOhEPPYFNAjih+OMAymEzWchB5DMO2wQjKU6J2DNA6pyQwwzc6 # 7q0lDBKrKfnwhOgdQoDpqm/SWdWWheWcbfu29pasaWvLx0tUujPJnXj7belkqwMb # evPlf+mcTT4Ypq5OHZ6iUc22RxLZ/e37PYt52GUVdmfrQgyt5haQ8nkreGUZkcYf # WFY2T94BiYrNvWSRIdS9Vfv7tKPXjHg/uN0kvaY2citsMuubam6FJeRpNGIcDIay # ZxaiZ5i3m9BUw0uuAJaMTIR5N0di4FX02gz2R2DNU7uW1n0BZAymyYZlimiJ0XPW # XTCDTOB3KPxgSikjRbCriR3UwE5oua83b1TKtj4ShdLdhrHts9C2gItrUT3gUj93 # HVbby9tF18xuBhWpKJyCeYj0fbresC3GmsvOCd3kg1woKCBegV6q2ztfIGIe5NiV # rcSMrjurzHxkGlLHJ4EjH52tQySRSlkXKLEUAfd6XxNlAFspIX76tUlXBvL+JZl2 # 9uUPMOzTegGVNfUMgVpoEjullA5bzuwhV/1rr0wUcI1NS+523ByGCTakB0Z+0jO4 # S9dfYLcO8cHezdPKVn6i58fN/ErAwkeBtonZ6v9Y3uXFOXHfSqDeTDM4DK2WjL1V # BbPVeCP5KqE7MfJZmoQQ3fs= # SIG # End signature block |