Commands/AffiliateApplication/AffiliateApplication.ps1

#region Copyright & License

# Copyright © 2012 - 2022 François Chabot
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

#endregion

Set-StrictMode -Version Latest

function Get-AffiliateApplication {
   [CmdletBinding()]
   [OutputType([AffiliateApplication[]])]
   param(
      [Alias('Name')]
      [Parameter(Position = 0, Mandatory = $false)]
      [ValidateNotNullOrEmpty()]
      [string[]]
      $AffiliateApplicationName
   )
   Resolve-ActionPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState

   if ([string]::IsNullOrEmpty($AffiliateApplicationName)) {
      [AffiliateApplication]::FindByContact()
   } elseif ($AffiliateApplicationName -eq [AffiliateApplication]::ANY_CONTACT_INFO) {
      [AffiliateApplication]::FindByContact([AffiliateApplication]::ANY_CONTACT_INFO)
   } else {
      [AffiliateApplication]::FindByName($AffiliateApplicationName)
   }
}

function Get-AffiliateApplicationStore {
   [CmdletBinding()]
   [OutputType([ConfigStore[]])]
   param(
      [Alias('Name')]
      [Parameter(Position = 0, Mandatory = $true)]
      [ValidateNotNullOrEmpty()]
      [string[]]
      $AffiliateApplicationName,

      [Parameter(Mandatory = $false)]
      [switch]
      $Any
   )
   Resolve-ActionPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState

   Get-AffiliateApplication -AffiliateApplicationName $AffiliateApplicationName | ForEach-Object -Process {
      if ($Any) {
         $_.ConfigStores
      } else {
         $_.ConfigStores.Default
      }
   }
}

function New-AffiliateApplication {
   [CmdletBinding()]
   [OutputType([AffiliateApplication])]
   param(
      [Alias('Name')]
      [Parameter(Position = 0, Mandatory = $true)]
      [ValidateNotNullOrEmpty()]
      [string]
      $AffiliateApplicationName,

      [Parameter(Position = 1, Mandatory = $false)]
      [ValidateNotNullOrEmpty()]
      [string[]]
      $AdministratorGroup,

      [Parameter(Position = 1, Mandatory = $false)]
      [ValidateNotNullOrEmpty()]
      [string[]]
      $UserGroup
   )
   Resolve-ActionPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState

   $affiliateApplication = [AffiliateApplication]::FindByName($AffiliateApplicationName)
   if ($null -eq $affiliateApplication) {
      $affiliateApplication = [AffiliateApplication]::Create($AffiliateApplicationName, $AdministratorGroup, $UserGroup)
   } else {
      Write-Warning "SSO Affiliate Application $AffiliateApplicationName already exists."
   }
   $affiliateApplication
}

function Remove-AffiliateApplication {
   [CmdletBinding()]
   [OutputType([void])]
   param(
      [Alias('Name')]
      [Parameter(Position = 0, Mandatory = $true)]
      [ValidateNotNullOrEmpty()]
      [string]
      $AffiliateApplicationName
   )
   Resolve-ActionPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState

   $affiliateApplication = [AffiliateApplication]::FindByName($AffiliateApplicationName)
   if ($null -eq $affiliateApplication) {
      Write-Warning "SSO Affiliate Application $AffiliateApplicationName does not exist."
   } else {
      $affiliateApplication.Delete()
   }
}

function Update-AffiliateApplicationStore {
   [CmdletBinding()]
   [OutputType([ConfigStore])]
   param(
      [Alias('Name')]
      [Parameter(Position = 0, Mandatory = $true)]
      [ValidateNotNullOrEmpty()]
      [string]
      $AffiliateApplicationName,

      [Alias('ProbingPath')]
      [Parameter(Mandatory = $false)]
      [ValidateNotNullOrEmpty()]
      [ValidateScript({ $_ | Test-Path -PathType Container })]
      [string[]]
      $AssemblyProbingFolderPath,

      [Alias('Path')]
      [Parameter(Position = 1, Mandatory = $true)]
      [ValidateNotNullOrEmpty()]
      [ValidateScript( { Test-Path -Path $_ -PathType Leaf } )]
      [string]
      $EnvironmentSettingsAssemblyFilePath,

      [Alias('SettingsTypeName')]
      [Parameter(Mandatory = $false)]
      [ValidateNotNullOrEmpty()]
      [string]
      $EnvironmentSettingOverridesTypeName,

      [Parameter(Mandatory = $false)]
      [switch]
      $Isolated,

      [Alias('Environment')]
      [Parameter(Position = 2, Mandatory = $true)]
      [ValidateNotNullOrEmpty()]
      [string]
      $TargetEnvironment
   )
   Resolve-ActionPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState

   $arguments = Get-CoreCommandArguments $PSBoundParameters
   if ($Isolated) {
      Write-Information "Dispatching Update of SSO AffiliateApplication '$AffiliateApplicationName''s ConfigStore to Isolated Process..."
      Invoke-Command -ComputerName $env:COMPUTERNAME -UseSSL -ScriptBlock {
         Import-Module $using:coreModulePath
         Update-CoreAffiliateApplicationStore @using:arguments
      }
   } else {
      Update-CoreAffiliateApplicationStore @arguments
   }
}

<#
 # Argument Completers
 #>


Register-ArgumentCompleter -CommandName Get-AffiliateApplication, Get-AffiliateApplicationStore -ParameterName AffiliateApplicationName -ScriptBlock {
   param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters)
   @('*') + $([AffiliateApplication]::FindByContact('*').Name) | Where-Object -FilterScript { $_ -match $wordToComplete } | ForEach-Object -Process { "'$_'" }
}

Register-ArgumentCompleter -CommandName Remove-AffiliateApplication, Update-AffiliateApplicationStore -ParameterName AffiliateApplicationName -ScriptBlock {
   param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameters)
   # forbid to remove or update all AffiliateApplication, so don't return '*' as an argument candidate;
   # forbid to remove or update an AffiliateApplication that has not been created by Be.Stateless.BizTalk.Settings, so call FindByContact()
   # which uses the DEFAULT_CONTACT_INFO (i.e. "icraftsoftware@stateless.be") and do not call FindByContact('*')
   $([AffiliateApplication]::FindByContact().Name) | Where-Object -FilterScript { $_ -match $wordToComplete } | ForEach-Object -Process { "'$_'" }
}

<#
 # Type Accelerators
 #>


$Accelerators = [PSObject].Assembly.GetType('System.Management.Automation.TypeAccelerators')
$Accelerators::Add('AffiliateApplication', 'Be.Stateless.BizTalk.Settings.Sso.AffiliateApplication')
$Accelerators::Add('ConfigStore', 'Be.Stateless.BizTalk.Settings.Sso.AffiliateApplication')

# SIG # Begin signature block
# MIII0QYJKoZIhvcNAQcCoIIIwjCCCL4CAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB
# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR
# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQU3QbtqgQJ+TUfPUJpOQ1nHPgw
# LW+gggVMMIIFSDCCAzCgAwIBAgIJAJkr3mJdTBkUMA0GCSqGSIb3DQEBCwUAMEEx
# PzA9BgNVBAMeNgBpAGMAcgBhAGYAdABzAG8AZgB0AHcAYQByAGUAQABzAHQAYQB0
# AGUAbABlAHMAcwAuAGIAZTAeFw0yMTA2MjUxNDEyMjNaFw00MTA2MjAxNDEyMjNa
# MEExPzA9BgNVBAMeNgBpAGMAcgBhAGYAdABzAG8AZgB0AHcAYQByAGUAQABzAHQA
# YQB0AGUAbABlAHMAcwAuAGIAZTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoC
# ggIBAOeqdUHBv7sxSeX3aj6yPKj7PAvs8izpVXjyEBl5aR8mQneVcXuF53AH7EW1
# 6E5p4+Az5pJPGUD5c3tXhiGMF7vgLhQjO6hlaVBRIqiIYHikNLwMNy6YBMc/QQYM
# rPhqHEFsZ53dkBIIj3M8e3kFcTFA09n25yDtTPDab4nd9yUhc9Qc8+nfpIzfYsoP
# 1pZ3nCzhw6hN2/44v1dkQrG3dRYwt+px65p6NPNZWEJpt4VCJjIFh+lBYJdxm9d4
# X/rAnlHIkbv7liOavWDzgHVabS3hdAWtcDmynm+7+FcZDFqPWNCl3e4SS7xe4s/R
# CKFKA0IsfKkSk9YJlLgeSQIEXUOOWXJAGaLqnRD8xWLZsc4Oi9GZg7XV1mv/S88c
# oztXnwtAN3OOlRKBh2QbomMgxeMO0GvsLE/cq5Q/YKAoz+KGr/7LcZq9jzQ8IPus
# ZvWLeDXmxPiwJjpZc1koLgfGIEX2NStQTT3QmacWr9thrWcKvI+4uBmI4exS9B4a
# R3nV91w5EY+2RoYsHqej9LWwNamO96+jMX9pxprTX+EkLUuMAikw/po8sBC9MUUn
# 5pMWmUv7DCtQOLGGBDDMMMkn4ZcjpCEEdPGHRKfqNnD27ssGtDjiNzfQrsm67toU
# bBwUF+gyJq/YckWquYJhA9ZOFWEADuIwGnsOzsoRvuQyY+p9AgMBAAGjQzBBMA4G
# A1UdDwEB/wQEAwIHgDAWBgNVHSUBAf8EDDAKBggrBgEFBQcDAzAXBgNVHREEEDAO
# ggxzdGF0ZWxlc3MuYmUwDQYJKoZIhvcNAQELBQADggIBACithYM3qckZRc9+Xbfu
# a6gWr3HwjrW+FHKgjfrcOm8ZnLVapb9xFqsqrRQqd3RXWQDINEGrtI2rSfrzyfoK
# UiTgldIfQNP1ZcGY229d++90t3hdo2mlt05hjYlbMENloJHpsEP0vQZmwOcEimCT
# ex1pymYM+P9pj3j8UD1PT1eIZot6or8fBRl63UybyDSrM7L4UOkkAOniKxWy5pW6
# 6duS8SR+SZpr3Bv44NyXPj0Nv+MIpLmsLrd7XPBFmnGxzY01ZO9vzi9KEhM2wT5i
# jPqHDNOvfPiADtAa+EyUBzdJiqy9heCz/TMZQgMWGwtfqJNxWZmsHcha2anW4Qt+
# mzrLO4GojWoVog9uVSAq+l0a+YQsd1u1kUmm4vgZCFyUA+lEp4LkI7ca2VBHkLPD
# w+u2DoDMRiqFPZjO7BCKjGc0jj9B/qGR3JVt+tqDdB621xXf2YGF2oFvxZQ/keGt
# 0ujfJ+JwN3nCulDAA4773q6KUnfykyrvAgITNbRJL6TngeRKtw9VIJBPxzqMzLpV
# 5ggXNituwLaD1CCBJ1oo9DZHpL9gplXp1wGrelJOTiJhh+pdNsPtRH7CrranWa5h
# LFLuigqin0eewQ5giJ1VaiBVEseOmiZog+27UpFIv40aDzgGL3YxB/Mu0ojwrQtp
# WLmqJCmWnR5qxOm0yK+zNWe0MYIC7zCCAusCAQEwTjBBMT8wPQYDVQQDHjYAaQBj
# AHIAYQBmAHQAcwBvAGYAdAB3AGEAcgBlAEAAcwB0AGEAdABlAGwAZQBzAHMALgBi
# AGUCCQCZK95iXUwZFDAJBgUrDgMCGgUAoHgwGAYKKwYBBAGCNwIBDDEKMAigAoAA
# oQKAADAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgorBgEEAYI3AgELMQ4w
# DAYKKwYBBAGCNwIBFTAjBgkqhkiG9w0BCQQxFgQU+BW4BYdQursn+sE8EirrU5Fa
# qyUwDQYJKoZIhvcNAQEBBQAEggIAdPpxBPQ0iOHh5DFook/9o+wyoQLdTfLxAoxR
# U5ASfETG50TetQFDFEt1cULvUANl889YhVepEPBKm3R5lApl79X7Y1QtXd1f6Ygl
# mC9w7VXwDhJJtU+Etk6zjAFTP2aYuQBcTrV4oFnkuijt/4Odq6CnyIifrrzS/Hd2
# fqaRdn7jeHrYL20bmx7JR2s3AbJGAEb92EGGXJp0s/84ykbJa/d+/tMyW5BlCMn0
# 5/UY0qWH2XYg3rm4RJXVHI05MjIFvvw6s3pSjSqk7byP7lsTUnOrHxC2EdqOXuuV
# qsTttAQbxYOQngH7TQu+g+NJBYKz4y6twPJR9aza5ElRLrxy0V5HiEhPWKHVwlE0
# 1mS1JY3vTABCcjAlomnUuswS8TJKKR3JzHQV+EsOcWECkNgl+1WUxfm454kluyxe
# 4MQv8mqDcmOAs/Ekii9IaHeHzmitzYHPINNRBWKsaEaXSHUAp4p6A4o+2perYOBl
# id3fvMvdhHJ9kFLOOAmnGZ6Nuix6vkVgYEc1NCcmupUt3WyOpJTb7cNyWXBjZwyd
# vHqKyThqF3NbX/ckqUPnnCrhLbvcJvLZwuIfOwK+NCKi8vZp6gIWGH5Q+mVN3Ssh
# 6NbiEp9JELwAvsk9jK7LwP1xjHEbDa2BSgRwq099FU//wGqYI3UFok1kP6/hiPiY
# j3O0oy4=
# SIG # End signature block