AtlassianPS.Configuration.psm1
|
#region Dependencies # Load the Module's namespace from C# if (-not("AtlassianPS.ServerData" -as [Type])) { $assemblyReferences = @( 'Microsoft.CSharp' 'Microsoft.PowerShell.Commands.Utility' 'System.Management.Automation' 'System.Runtime.Extensions' 'System.Security.Cryptography.X509Certificates' ) if ($PSVersionTable.PSEdition -eq 'Core') { $assemblyReferences += 'System.Security.Cryptography' } Add-Type -Path (Join-Path $PSScriptRoot AtlassianPS.Configuration.Types.cs) -ReferencedAssemblies $assemblyReferences } if ($PSVersionTable.PSVersion.Major -lt 5) { Add-Type -Path (Join-Path $PSScriptRoot AtlassianPS.Configuration.Attributes.cs) -ReferencedAssemblies Microsoft.CSharp, Microsoft.PowerShell.Commands.Utility, System.Management.Automation, System.Runtime.Extensions, System.Security.Cryptography.X509Certificates } #endregion Dependencies #region ModuleConfig # Add our own Converters for serialization Add-MetadataConverter @{ [AtlassianPS.MessageStyle] = { "AtlassianPSMessageStyle -Indent {0} -TimeStamp {1} -BreadCrumbs {2} -FunctionName {3}" -f (ConvertTo-Metadata $_.Indent), (ConvertTo-Metadata $_.TimeStamp), (ConvertTo-Metadata $_.BreadCrumbs), (ConvertTo-Metadata $_.FunctionName) } AtlassianPSMessageStyle = { param($Indent, $TimeStamp, $BreadCrumbs, $FunctionName) [AtlassianPS.MessageStyle]$PSBoundParameters } [AtlassianPS.ServerData] = { "AtlassianPSServerData -Id {0} -Name '{1}' -Uri '{2}' -Type '{3}' -Headers {4}" -f $_.Id, $_.Name, $_.Uri, $_.Type, (ConvertTo-Metadata $_.Headers) } AtlassianPSServerData = { param($Id, $Name, $Uri, $Type, $Headers) if ([string]::IsNullOrEmpty($Headers)) { $Headers = $null } [AtlassianPS.ServerData]$PSBoundParameters } } #region LoadFunctions #region Add-ServerConfiguration function Add-ServerConfiguration { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [CmdletBinding( ConfirmImpact = 'Low', SupportsShouldProcess = $true )] [OutputType( [void] )] param( [Parameter( Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName )] [Alias('Url', 'Address')] [ValidateScript( { $_.IsAbsoluteUri } )] [Uri] $Uri, [Parameter( ValueFromPipelineByPropertyName )] [ValidateNotNullOrEmpty()] [Alias('ServerName', 'Alias')] [String] $Name, [Parameter( Mandatory, ValueFromPipelineByPropertyName )] [AtlassianPS.ServerType] $Type, [Parameter( ValueFromPipelineByPropertyName )] [Microsoft.PowerShell.Commands.WebRequestSession] $Session, [Parameter( ValueFromPipelineByPropertyName )] [Hashtable] $Headers ) begin { Write-Verbose "Function started" $serverList = [System.Collections.Generic.List[AtlassianPS.ServerData]]::new() foreach ($server in @(Get-ServerConfiguration)) { $serverList.Add($server) } $configurationChanged = $false } process { Write-DebugMessage "ParameterSetName: $($PsCmdlet.ParameterSetName)" Write-DebugMessage "PSBoundParameters: $($PSBoundParameters | Out-String)" $entryName = if ($PSBoundParameters.ContainsKey('Name')) { $Name } else { $Uri.Authority } $entryHeaders = if ($PSBoundParameters.ContainsKey('Headers')) { $Headers } else { @{} } if ($serverList | Where-Object Name -eq $entryName) { $writeErrorSplat = @{ ExceptionType = "System.ApplicationException" Message = "An entry with name [$entryName] already exists" ErrorId = "AtlassianPS.ServerData.EntryExists" Category = "InvalidData" TargetObject = $entryName } WriteError @writeErrorSplat } elseif ($PSCmdlet.ShouldProcess($entryName, "Add server configuration")) { if (-not ($index = ($serverList.Id | Measure-Object -Maximum).Maximum)) { $index = 0 } $index++ $config = [AtlassianPS.ServerData]@{ Id = $index Name = $entryName Uri = ([Uri]($Uri.AbsoluteUri -replace "\/$", "")) Type = $Type # IsCloudServer = (Test-ServerIsCloud -Type $Type -Uri $Uri -Headers $Headers -ErrorAction Stop -verbose) Session = $Session Headers = $entryHeaders } Write-Verbose "Adding server #$($index): [$($config.Name)]" Write-DebugMessage "Adding server `$config: $($config.Name) @ index $index" -BreakPoint $serverList.Add($config) $configurationChanged = $true } } end { if ($configurationChanged) { Write-DebugMessage "Persisting ServerList" $script:Configuration["ServerList"] = $serverList Save-Configuration } Write-Verbose "Function ended" } } #endregion Add-ServerConfiguration #region Get-Configuration function Get-Configuration { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [CmdletBinding( DefaultParameterSetName = 'asObject' )] [OutputType( [PSCustomObject], ParameterSetName = 'asObject' )] [OutputType( [PSObject], ParameterSetName = 'asValue' )] [OutputType( [Hashtable], ParameterSetName = 'asHashTable' )] param( [Parameter( ValueFromPipeline, ValueFromPipelineByPropertyName )] [ValidateNotNullOrEmpty()] [SupportsWildcards()] [ArgumentCompleter( { param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameter) $command = "Get-Configuration" $module = (Get-Command -Name $commandName).Module $commandName = $module.ExportedCommands.Keys | Where-Object { $_ -like ($command -replace "-", "-$($module.Prefix)") } & $commandName | Where-Object { $_.Name -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new( $_.Name, $_.Name, [System.Management.Automation.CompletionResultType]::ParameterValue, $_.Name ) } } )] [String[]] $Name = '*', [Parameter( Mandatory, ParameterSetName = 'asValue' )] [Switch] $ValueOnly, [Parameter( Mandatory, ParameterSetName = 'asHashtable' )] [Switch] $AsHashtable ) begin { Write-Verbose "Function started" } process { Write-DebugMessage "ParameterSetName: $($PsCmdlet.ParameterSetName)" Write-DebugMessage "PSBoundParameters: $($PSBoundParameters | Out-String)" $data = @{} foreach ($_name in $Name) { Write-Verbose "Filtering for [name = $_name]" foreach ($key in ($script:Configuration.Keys | Where-Object { $_ -like $_name })) { Write-DebugMessage "Found [key = $key]" $data[$key] = $script:Configuration[$key] } } if ($AsHashtable) { $data } elseif ($ValueOnly) { $data.Values } else { foreach ($key in $data.Keys) { New-Object -TypeName PSCustomObject -Property @{ Name = $key; Value = $data[$key] } } } } end { Write-Verbose "Function ended" } } #endregion Get-Configuration #region Get-ServerConfiguration function Get-ServerConfiguration { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [CmdletBinding( DefaultParameterSetName = '_All' )] [OutputType( [AtlassianPS.ServerData] )] param( [Parameter( Position = 0, Mandatory, ParameterSetName = 'ServerDataByUri' )] [ArgumentCompleter( { param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameter) $command = "Get-ServerConfiguration" $module = (Get-Command -Name $commandName).Module $commandName = $module.ExportedCommands.Keys | Where-Object { $_ -like ($command -replace "-", "-$($module.Prefix)") } & $commandName | Where-Object { $_.Name -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new( $_.Name, $_.Name, [System.Management.Automation.CompletionResultType]::ParameterValue, $_.Name ) } } )] [Alias('Url', 'Address')] [Uri] $Uri, [Parameter( Position = 0, Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName, ParameterSetName = 'ServerDataByName' )] [ArgumentCompleter( { param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameter) $command = "Get-ServerConfiguration" $module = (Get-Command -Name $commandName).Module $commandName = $module.ExportedCommands.Keys | Where-Object { $_ -like ($command -replace "-", "-$($module.Prefix)") } & $commandName | Where-Object { $_.Uri -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new( $_.Name, $_.Name, [System.Management.Automation.CompletionResultType]::ParameterValue, $_.Name ) } } )] [Alias('ServerName', 'Alias')] [String[]] $Name ) begin { Write-Verbose "Function started" $serverList = Get-Configuration -Name ServerList -ValueOnly } process { Write-DebugMessage "ParameterSetName: $($PsCmdlet.ParameterSetName)" Write-DebugMessage "PSBoundParameters: $($PSBoundParameters | Out-String)" switch ($PsCmdlet.ParameterSetName) { 'ServerDataByName' { Write-Verbose "Filtering ServerList for [Name = $Name]" $serverList | Where-Object { $_.Name -in $Name } } 'ServerDataByUri' { Write-Verbose "Filtering ServerList for [URI = $Uri]" $serverList | Where-Object { $_.Uri -like $Uri } } '_All' { $serverList } } } end { Write-Verbose "Function ended" } } #endregion Get-ServerConfiguration #region Remove-Configuration function Remove-Configuration { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [CmdletBinding( ConfirmImpact = 'Low', SupportsShouldProcess = $true )] [OutputType( [void] )] param( [Parameter( Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName )] [ValidateNotNullOrEmpty()] [ArgumentCompleter( { param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameter) $command = "Get-Configuration" $module = (Get-Command -Name $commandName).Module $commandName = $module.ExportedCommands.Keys | Where-Object { $_ -like ($command -replace "-", "-$($module.Prefix)") } & $commandName | Where-Object { $_.Name -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new( $_.Name, $_.Name, [System.Management.Automation.CompletionResultType]::ParameterValue, $_.Name ) } } )] [String[]] $Name ) begin { Write-Verbose "Function started" $reservedNames = @('ServerList') $configurationChanged = $false } process { Write-DebugMessage "ParameterSetName: $($PsCmdlet.ParameterSetName)" Write-DebugMessage "PSBoundParameters: $($PSBoundParameters | Out-String)" foreach ($_name in $Name) { if ($_name -in $reservedNames) { $writeErrorSplat = @{ ExceptionType = "System.ApplicationException" Message = "Configuration key [$_name] is reserved and cannot be removed with Remove-Configuration" ErrorId = "AtlassianPS.Configuration.ReservedKey" Category = "InvalidArgument" TargetObject = $_name } WriteError @writeErrorSplat continue } Write-Verbose "Filtering for [name = $_name]" if ($PSCmdlet.ShouldProcess($_name, "Remove configuration key")) { $configurationChanged = $script:Configuration.Remove($_name) -or $configurationChanged } } } end { if ($configurationChanged) { Save-Configuration } Write-Verbose "Function ended" } } #endregion Remove-Configuration #region Remove-ServerConfiguration function Remove-ServerConfiguration { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [CmdletBinding( ConfirmImpact = 'Low', SupportsShouldProcess = $true )] [OutputType( [void] )] param( [Parameter( Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName )] [ArgumentCompleter( { param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameter) $commandName = (Get-Command -Module "AtlassianPS.Configuration" -Name "Get-*ServerConfiguration").Name & $commandName | Where-Object { $_.Name -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new( $_.Name, $_.Name, [System.Management.Automation.CompletionResultType]::ParameterValue, $_.Name ) } } )] [Alias('ServerName', 'Alias')] [ValidateNotNullOrEmpty()] [String[]] $Name ) begin { Write-Verbose "Function started" $serverList = [System.Collections.Generic.List[AtlassianPS.ServerData]]::new() foreach ($server in @(Get-ServerConfiguration)) { $serverList.Add($server) } $configurationChanged = $false } process { Write-DebugMessage "ParameterSetName: $($PsCmdlet.ParameterSetName)" Write-DebugMessage "PSBoundParameters: $($PSBoundParameters | Out-String)" foreach ($serverToRemove in $Name) { if ($serverToRemove -notin $serverList.Name) { $writeErrorSplat = @{ ExceptionType = "System.ApplicationException" ErrorId = "AtlassianPS.ServerData.ServerNotFound" Category = "ObjectNotFound" Message = "No server '$serverToRemove' could be found." TargetObject = $serverToRemove Cmdlet = $PSCmdlet } WriteError @writeErrorSplat } } foreach ($serverToRemove in $Name) { if ($serverToRemove -in $serverList.Name -and $PSCmdlet.ShouldProcess($serverToRemove, "Remove server configuration")) { $remainingServers = [System.Collections.Generic.List[AtlassianPS.ServerData]]::new() foreach ($server in $serverList) { if ($server.Name -ne $serverToRemove) { $remainingServers.Add($server) } } $serverList = $remainingServers $configurationChanged = $true } } } end { if ($configurationChanged) { Write-DebugMessage "Persisting ServerList" $script:Configuration.Remove("ServerList") $script:Configuration.Add("ServerList", $serverList) Save-Configuration } Write-Verbose "Function ended" } } #endregion Remove-ServerConfiguration #region Set-Configuration function Set-Configuration { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [CmdletBinding( ConfirmImpact = 'Low', SupportsShouldProcess = $true )] [OutputType( [PSCustomObject] )] param( [Parameter( Mandatory, ValueFromPipelineByPropertyName )] [ValidateNotNullOrEmpty()] [ArgumentCompleter( { param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameter) $command = "Get-Configuration" $module = (Get-Command -Name $commandName).Module $commandName = $module.ExportedCommands.Keys | Where-Object { $_ -like ($command -replace "-", "-$($module.Prefix)") } & $commandName | Where-Object { $_.Name -like "$wordToComplete*" } | ForEach-Object { [System.Management.Automation.CompletionResult]::new( $_.Name, $_.Name, [System.Management.Automation.CompletionResultType]::ParameterValue, $_.Name ) } } )] [String] $Name, [Parameter( ValueFromPipelineByPropertyName )] [AllowNull()] [AllowEmptyCollection()] [AllowEmptyString()] [Object] $Value, [Switch] $Append, [Switch] $Passthru ) begin { Write-Verbose "Function started" $reservedNames = @('ServerList') $configurationChanged = $false } process { Write-DebugMessage "ParameterSetName: $($PsCmdlet.ParameterSetName)" Write-DebugMessage "PSBoundParameters: $($PSBoundParameters | Out-String)" if ($Name -in $reservedNames) { $writeErrorSplat = @{ ExceptionType = "System.ApplicationException" Message = "Configuration key [$Name] is reserved and cannot be changed with Set-Configuration" ErrorId = "AtlassianPS.Configuration.ReservedKey" Category = "InvalidArgument" TargetObject = $Name } WriteError @writeErrorSplat return } if ($Append) { Write-Verbose "Appending to existing value" $oldValue = (Get-Configuration -Name $Name -ValueOnly) if ($null -eq $oldValue) { $newValue = @($Value) } else { try { $newValue = @(@($oldValue) + @($Value)) -as ($oldValue.GetType()) if (-not $newValue) { throw "failed to cast to $($oldValue.GetType().Name)" } } catch { Write-DebugMessage $_ $newValue = @(@($oldValue) + @($Value)) } } $Value = $newValue } if ($Value) { $dataType = $Value.GetType().Name } else { $dataType = "null" } Write-Verbose "Storing value [$dataType] to [name = $Name]" if ($PSCmdlet.ShouldProcess($Name, "Set configuration value")) { $script:Configuration.Remove($Name) $script:Configuration.Add($Name, $Value) $configurationChanged = $true if ($Passthru) { Get-Configuration -Name $Name } } } end { if ($configurationChanged) { Save-Configuration } Write-Verbose "Function ended" } } #endregion Set-Configuration #region Set-ServerConfiguration function Set-ServerConfiguration { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [CmdletBinding( ConfirmImpact = 'Low', SupportsShouldProcess = $true )] [OutputType( [void] )] param( [Parameter( Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName )] [ValidateRange(1, [UInt32]::MaxValue)] [UInt32] $Id, [Parameter()] [ValidateNotNullOrEmpty()] [Alias('Url', 'Address')] [ValidateScript( { $_.IsAbsoluteUri } )] [Uri] $Uri, [Parameter()] [ValidateNotNullOrEmpty()] [Alias('ServerName', 'Alias')] [String] $Name = $Uri.Authority, [Parameter()] [ValidateNotNullOrEmpty()] [AtlassianPS.ServerType] $Type, [Parameter()] [Microsoft.PowerShell.Commands.WebRequestSession] $Session, [Parameter()] [Hashtable] $Headers ) begin { Write-Verbose "Function started" $parametersToIgnore = @( 'Id' 'Verbose' 'Debug' 'ErrorAction' 'WarningAction' 'InformationAction' 'ErrorVariable' 'WarningVariable' 'InformationVariable' 'OutVariable' 'OutBuffer' 'PipelineVariable' 'WhatIf' 'Confirm' ) $configurationChanged = $false } process { Write-DebugMessage "ParameterSetName: $($PsCmdlet.ParameterSetName)" Write-DebugMessage "PSBoundParameters: $($PSBoundParameters | Out-String)" $serverEntry = Get-ServerConfiguration | Where-Object { $_.Id -eq $Id } if ($serverEntry) { if ($PSBoundParameters.ContainsKey('Name') -and (Get-ServerConfiguration | Where-Object { $_.Id -ne $Id -and $_.Name -eq $Name })) { $writeErrorSplat = @{ ExceptionType = "System.ApplicationException" Message = "An entry with name [$Name] already exists" ErrorId = "AtlassianPS.ServerData.EntryExists" Category = "InvalidData" TargetObject = $Name } WriteError @writeErrorSplat return } if ($PSCmdlet.ShouldProcess("#$Id ($($serverEntry.Name))", "Update server configuration")) { foreach ($property in ($PSBoundParameters.Keys | Where-Object { $_ -notin $parametersToIgnore } )) { Write-Verbose "Changing [$property] of entry #$Id" $serverEntry.$property = Get-Variable $property -ValueOnly $configurationChanged = $true } } } else { $writeErrorSplat = @{ ExceptionType = "System.ApplicationException" Message = "No entry could be found at index $Id" ErrorId = "AtlassianPS.ServerData.NoEntryExists" Category = "InvalidData" TargetObject = $Id } WriteError @writeErrorSplat } } end { if ($configurationChanged) { Save-Configuration } Write-Verbose "Function ended" } } #endregion Set-ServerConfiguration #region ConvertFrom-QueryString function ConvertFrom-QueryString { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [CmdletBinding(DefaultParameterSetName = 'ByString')] [OutputType([Hashtable])] param( [Parameter(Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName, ParameterSetName = 'ByUri')] [Uri] $Uri, [Parameter(Mandatory, Position = 0, ValueFromPipeline, ParameterSetName = 'ByString')] [String] $Query ) process { $getParameter = @{} if ($Uri) { $Query = $Uri.Query } if (($Query -match '^\?.+') -or ($Query -match '=')) { $Query.TrimStart('?').Split('&') | ForEach-Object { $key, $value = $_.Split('=', 2) if (-not [String]::IsNullOrEmpty($key)) { $decodedKey = ConvertFrom-URLEncoded -InputString $key $decodedValue = if ([String]::IsNullOrEmpty($value)) { $value } else { ConvertFrom-URLEncoded -InputString $value } $getParameter[$decodedKey] = $decodedValue } } } $getParameter } } #endregion ConvertFrom-QueryString #region ConvertFrom-URLEncoded function ConvertFrom-URLEncoded { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [CmdletBinding()] [OutputType([String])] param( [Parameter(Mandatory, ValueFromPipeline)] [String[]] $InputString ) begin { Import-HttpUtility } process { foreach ($string in $InputString) { [System.Web.HttpUtility]::UrlDecode($string) } } } #endregion ConvertFrom-URLEncoded #region ConvertTo-Hashtable function ConvertTo-Hashtable { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [CmdletBinding()] [OutputType([Hashtable])] param( [Parameter(Mandatory, ValueFromPipeline)] [PSObject] $InputObject ) process { $hash = @{} foreach ($property in $InputObject.PSObject.Properties) { $hash[$property.Name] = $property.Value } $hash } } #endregion ConvertTo-Hashtable #region ConvertTo-QueryString function ConvertTo-QueryString { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [CmdletBinding()] [OutputType([String])] param( [Parameter(Mandatory, ValueFromPipeline)] [Hashtable] $InputObject ) process { if ($InputObject.Count -eq 0) { return '' } $pairs = foreach ($key in $InputObject.Keys) { $encodedKey = ConvertTo-URLEncoded -InputString "$key" $value = $InputObject[$key] if ($null -eq $value -or "$value" -eq '') { "$encodedKey=" } else { "{0}={1}" -f $encodedKey, (ConvertTo-URLEncoded -InputString "$value") } } '?' + ($pairs -join '&') } } #endregion ConvertTo-QueryString #region ConvertTo-URLEncoded function ConvertTo-URLEncoded { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [CmdletBinding()] [OutputType([String])] param( [Parameter(Mandatory, ValueFromPipeline)] [String[]] $InputString ) begin { Import-HttpUtility } process { foreach ($string in $InputString) { [System.Web.HttpUtility]::UrlEncode($string) } } } #endregion ConvertTo-URLEncoded #region Join-Hashtable function Join-Hashtable { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [CmdletBinding()] [OutputType([Hashtable])] param( [Parameter(Mandatory, ValueFromPipeline)] [AllowNull()] [System.Collections.IDictionary[]] $Hashtable, [Parameter()] [ValidateSet('Overwrite', 'Error')] [String] $OnDuplicate = 'Overwrite' ) begin { [Hashtable]$table = @{} $isInitialized = $false } process { foreach ($item in $Hashtable) { if ($null -eq $item) { continue } if (-not $isInitialized) { # Start from the first dictionary so key comparison behavior # (for example case sensitivity) is preserved. $table = [System.Collections.Hashtable]::new($item) $isInitialized = $true continue } foreach ($entry in $item.GetEnumerator()) { if ($OnDuplicate -eq 'Error' -and $table.Contains($entry.Key)) { $errorItem = [System.Management.Automation.ErrorRecord]::new( ([System.ArgumentException]::new("Duplicate key '$($entry.Key)' was encountered while joining hashtables.")), 'JoinHashtable.DuplicateKey', [System.Management.Automation.ErrorCategory]::InvalidArgument, $entry.Key ) $PSCmdlet.ThrowTerminatingError($errorItem) } $table[$entry.Key] = $entry.Value } } } end { $table } } #endregion Join-Hashtable #region Resolve-DefaultParameterValue function Resolve-DefaultParameterValue { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [CmdletBinding()] [OutputType([Hashtable])] param( [Parameter(Mandatory)] [Hashtable] $Reference, [Parameter(Mandatory)] [String[]] $CommandName, [Parameter()] [Hashtable] $Target = @{}, [Parameter()] [String[]] $ParameterName = '*' ) begin { $defaultItems = New-Object -TypeName System.Collections.ArrayList foreach ($key in $Reference.Keys) { $null = $defaultItems.Add( [PSCustomObject]@{ Key = $key Value = $Reference[$key] Command = $key.Split(':')[0] Parameter = $key.Split(':')[1] } ) } } process { foreach ($command in $CommandName) { foreach ($item in $defaultItems) { if ($command -notlike $item.Command) { continue } foreach ($parameter in $ParameterName) { if ($item.Parameter -like $parameter) { if ($parameter -ne '*') { $Target["${command}:$parameter"] = $item.Value } else { $Target["${command}:$($item.Parameter)"] = $item.Value } } } } } } end { $Target } } #endregion Resolve-DefaultParameterValue #region Resolve-FilePath function Resolve-FilePath { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [CmdletBinding()] [OutputType([String])] param( [Parameter(Mandatory, ValueFromPipeline)] [ValidateNotNullOrEmpty()] [Alias('PSPath', 'LiteralPath')] [String] $Path ) process { $folder = Split-Path -Path $Path -Parent $file = Split-Path -Path $Path -Leaf if (-not [String]::IsNullOrEmpty($folder)) { $folderResolved = Resolve-Path -Path $folder } else { $folderResolved = Resolve-Path -Path $ExecutionContext.SessionState.Path.CurrentFileSystemLocation } Join-Path -Path $folderResolved.ProviderPath -ChildPath $file } } #endregion Resolve-FilePath #region Write-DebugMessage function Write-DebugMessage { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [CmdletBinding()] param( [Parameter(ValueFromPipeline)] [String] $Message, [Parameter()] [Switch] $BreakPoint, [Parameter()] [ValidateNotNullOrEmpty()] [System.Management.Automation.PSCmdlet] $Cmdlet = $( try { (Get-Variable -Scope 1 -Name PSCmdlet -ErrorAction Stop).Value } catch { $PSCmdlet } ) ) begin { Import-MqcnAlias -Alias "WriteDebug" -Command "Microsoft.PowerShell.Utility\Write-Debug" $oldDebugPreference = $DebugPreference if (-not $BreakPoint -and $DebugPreference -ne 'SilentlyContinue') { $DebugPreference = 'Continue' } } process { $caller = Get-PSCallStack | Select-Object -Last 1 -Skip 1 | Select-Object -First 1 if ($caller -and $caller.Arguments -and $caller.Arguments.Contains("Debug")) { $DebugPreference = 'Continue' } Format-MessageStyle -Message $Message -Cmdlet $Cmdlet | ForEach-Object { WriteDebug $_ } } end { $DebugPreference = $oldDebugPreference } } #endregion Write-DebugMessage #region Write-NonTerminatingError function Write-NonTerminatingError { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [CmdletBinding(DefaultParameterSetName = 'ExistingException')] param( [Parameter()] [ValidateNotNullOrEmpty()] [System.Management.Automation.PSCmdlet] $Cmdlet = $( try { (Get-Variable -Scope 1 -Name PSCmdlet -ErrorAction Stop).Value } catch { $PSCmdlet } ), [Parameter(Mandatory, ParameterSetName = 'ExistingException', Position = 1, ValueFromPipeline, ValueFromPipelineByPropertyName)] [Parameter(ParameterSetName = 'NewException')] [ValidateNotNullOrEmpty()] [System.Exception] $Exception, [Parameter(ParameterSetName = 'NewException', Position = 2)] [ValidateNotNullOrEmpty()] [String] $ExceptionType = 'System.Management.Automation.RuntimeException', [Parameter(Mandatory, ParameterSetName = 'NewException', Position = 3)] [ValidateNotNullOrEmpty()] [String] $Message, [Parameter()] [Object] $TargetObject, [Parameter(Mandatory, ParameterSetName = 'ExistingException', Position = 10)] [Parameter(Mandatory, ParameterSetName = 'NewException', Position = 10)] [ValidateNotNullOrEmpty()] [String] $ErrorId, [Parameter(Mandatory, ParameterSetName = 'ExistingException', Position = 11)] [Parameter(Mandatory, ParameterSetName = 'NewException', Position = 11)] [ValidateNotNull()] [System.Management.Automation.ErrorCategory] $Category, [Parameter(Mandatory, ParameterSetName = 'Rethrow', Position = 1)] [System.Management.Automation.ErrorRecord] $ErrorRecord ) process { if (-not $Cmdlet) { throw 'Cmdlet runtime was not provided. Call this helper from an advanced function or pass -Cmdlet.' } if (-not $ErrorRecord) { $mode = if ($PSCmdlet.ParameterSetName -eq 'NewException') { 'NewException' } else { 'ExistingException' } $ErrorRecord = New-ErrorRecord ` -Mode $mode ` -Exception $Exception ` -ExceptionType $ExceptionType ` -Message $Message ` -ErrorId $ErrorId ` -Category $Category ` -TargetObject $TargetObject } $Cmdlet.WriteError($ErrorRecord) } } #endregion Write-NonTerminatingError #region Write-TerminatingError function Write-TerminatingError { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseShouldProcessForStateChangingFunctions', '')] [CmdletBinding(DefaultParameterSetName = 'ExistingException')] param( [Parameter()] [ValidateNotNullOrEmpty()] [System.Management.Automation.PSCmdlet] $Cmdlet = $( try { (Get-Variable -Scope 1 -Name PSCmdlet -ErrorAction Stop).Value } catch { $PSCmdlet } ), [Parameter(Mandatory, ParameterSetName = 'ExistingException', Position = 1, ValueFromPipeline, ValueFromPipelineByPropertyName)] [Parameter(ParameterSetName = 'NewException')] [ValidateNotNullOrEmpty()] [System.Exception] $Exception, [Parameter(ParameterSetName = 'NewException', Position = 2)] [ValidateNotNullOrEmpty()] [String] $ExceptionType = 'System.Management.Automation.RuntimeException', [Parameter(Mandatory, ParameterSetName = 'NewException', Position = 3)] [ValidateNotNullOrEmpty()] [String] $Message, [Parameter()] [Object] $TargetObject, [Parameter(Mandatory, ParameterSetName = 'ExistingException', Position = 10)] [Parameter(Mandatory, ParameterSetName = 'NewException', Position = 10)] [ValidateNotNullOrEmpty()] [String] $ErrorId, [Parameter(Mandatory, ParameterSetName = 'ExistingException', Position = 11)] [Parameter(Mandatory, ParameterSetName = 'NewException', Position = 11)] [ValidateNotNull()] [System.Management.Automation.ErrorCategory] $Category, [Parameter(Mandatory, ParameterSetName = 'Rethrow', Position = 1)] [System.Management.Automation.ErrorRecord] $ErrorRecord ) process { if (-not $Cmdlet) { throw 'Cmdlet runtime was not provided. Call this helper from an advanced function or pass -Cmdlet.' } if (-not $ErrorRecord) { $mode = if ($PSCmdlet.ParameterSetName -eq 'NewException') { 'NewException' } else { 'ExistingException' } $ErrorRecord = New-ErrorRecord ` -Mode $mode ` -Exception $Exception ` -ExceptionType $ExceptionType ` -Message $Message ` -ErrorId $ErrorId ` -Category $Category ` -TargetObject $TargetObject } $Cmdlet.ThrowTerminatingError($ErrorRecord) } } #endregion Write-TerminatingError #region Write-VerboseMessage function Write-VerboseMessage { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [CmdletBinding()] param( [Parameter(Mandatory, ValueFromPipeline)] [String] $Message, [Parameter()] [ValidateNotNullOrEmpty()] [System.Management.Automation.PSCmdlet] $Cmdlet = $( try { (Get-Variable -Scope 1 -Name PSCmdlet -ErrorAction Stop).Value } catch { $PSCmdlet } ) ) begin { Import-MqcnAlias -Alias "WriteVerbose" -Command "Microsoft.PowerShell.Utility\Write-Verbose" } process { $caller = Get-PSCallStack | Select-Object -Last 1 -Skip 1 | Select-Object -First 1 if ($caller -and $caller.Arguments -and $caller.Arguments.Contains("Verbose")) { $VerbosePreference = 'Continue' } Format-MessageStyle -Message $Message -Cmdlet $Cmdlet | ForEach-Object { WriteVerbose $_ } } } #endregion Write-VerboseMessage #region Get-BreadCrumb function Get-BreadCrumb { param( [String]$Delimiter = " > " ) $depth = 1 $path = New-Object -TypeName System.Collections.ArrayList while ($depth) { try { $null = $path.Add((Get-Variable MyInvocation -Scope $depth -ValueOnly).MyCommand.Name) $depth++ } catch { $depth = 0 } } $path.Remove("") $path -join $Delimiter } #endregion Get-BreadCrumb #region Import-MqcnAlias function Import-MqcnAlias { <# .SYNOPSIS Create an alias for a full command name .DESCRIPTION Create an alias for a full command name This can be used to create a mockable call to a full command name .EXAMPLE Import-MqcnAlias -Alias "GetItem" -Command Microsoft.PowerShell.Management\Get-Item --------- Description Create an alias "GetItem" for the normal Get-Item #> [CmdletBinding()] param( # Name of the alias to be used [Parameter( Mandatory )] [String] $Alias, # Name of the command for which to create the alias [Parameter( Mandatory )] [String] $Command ) begin { Set-Alias -Name $Alias -Value $Command -Scope 1 -WhatIf:$false } } #endregion Import-MqcnAlias #region Invoke-WebRequest function Invoke-WebRequest { # For Version up to 5.1 <# .ForwardHelpTargetName Microsoft.PowerShell.Utility\Invoke-WebRequest .ForwardHelpCategory Cmdlet #> [CmdletBinding(HelpUri = 'https://go.microsoft.com/fwlink/?LinkID=217035')] [Diagnostics.CodeAnalysis.SuppressMessageAttribute( "PSAvoidUsingConvertToSecureStringWithPlainText", "", Justification = "Converting received plaintext token to SecureString" )] param( [switch] ${UseBasicParsing}, [Parameter(Mandatory = $true, Position = 0)] [ValidateNotNullOrEmpty()] [uri] ${Uri}, [Microsoft.PowerShell.Commands.WebRequestSession] ${WebSession}, [Alias('SV')] [string] ${SessionVariable}, [pscredential] [System.Management.Automation.CredentialAttribute()] ${Credential} = [System.Management.Automation.PSCredential]::Empty, [switch] ${UseDefaultCredentials}, [ValidateNotNullOrEmpty()] [string] ${CertificateThumbprint}, [ValidateNotNull()] [System.Security.Cryptography.X509Certificates.X509Certificate] ${Certificate}, [string] ${UserAgent}, [switch] ${DisableKeepAlive}, [ValidateRange(0, 2147483647)] [int32] ${TimeoutSec}, [System.Collections.IDictionary] ${Headers}, [ValidateRange(0, 2147483647)] [int] ${MaximumRedirection}, [Microsoft.PowerShell.Commands.WebRequestMethod] ${Method}, [uri] ${Proxy}, [pscredential] [System.Management.Automation.CredentialAttribute()] ${ProxyCredential} = [System.Management.Automation.PSCredential]::Empty, [switch] ${ProxyUseDefaultCredentials}, [Parameter(ValueFromPipeline = $true)] [System.Object] ${Body}, [string] ${ContentType}, [ValidateSet('chunked', 'compress', 'deflate', 'gzip', 'identity')] [string] ${TransferEncoding}, [string] ${InFile}, [string] ${OutFile}, [switch] ${PassThru}) begin { if ($Credential) { $SecureCreds = [System.Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes( $('{0}:{1}' -f $Credential.UserName, $Credential.GetNetworkCredential().Password) )) $Headers["Authorization"] = "Basic $($SecureCreds)" $PSBoundParameters.Remove("Credential") } if ($InFile) { $boundary = [System.Guid]::NewGuid().ToString() $enc = [System.Text.Encoding]::GetEncoding("iso-8859-1") $fileName = Split-Path -Path $InFile -Leaf $readFile = Get-Content -Path $InFile -Encoding Byte $fileEnc = $enc.GetString($readFile) $PSBoundParameters["Body"] = @' --{0} Content-Disposition: form-data; name="file"; filename="{1}" Content-Type: application/octet-stream {2} --{0}-- '@ -f $boundary, $fileName, $fileEnc $PSBoundParameters["Headers"]['X-Atlassian-Token'] = 'nocheck' $PSBoundParameters["ContentType"] = "multipart/form-data; boundary=`"$boundary`"" $null = $PSBoundParameters.Remove("InFile") } try { $outBuffer = $null if ($PSBoundParameters.TryGetValue('OutBuffer', [ref]$outBuffer)) { $PSBoundParameters['OutBuffer'] = 1 } $wrappedCmd = $ExecutionContext.InvokeCommand.GetCommand('Microsoft.PowerShell.Utility\Invoke-WebRequest', [System.Management.Automation.CommandTypes]::Cmdlet) $scriptCmd = { & $wrappedCmd @PSBoundParameters } $steppablePipeline = $scriptCmd.GetSteppablePipeline($myInvocation.CommandOrigin) $steppablePipeline.Begin($PSCmdlet) } catch { throw } } process { try { $steppablePipeline.Process($_) if ($SessionVariable) { Set-Variable -Name $SessionVariable -Value (Get-Variable $SessionVariable).Value -Scope 1 } } catch { throw } } end { try { $steppablePipeline.End() } catch { throw } } } if ($PSVersionTable.PSVersion.Major -ge 6) { function Invoke-WebRequest { #require -Version 6 <# .ForwardHelpTargetName Microsoft.PowerShell.Utility\Invoke-WebRequest .ForwardHelpCategory Cmdlet #> [CmdletBinding(DefaultParameterSetName = 'StandardMethod', HelpUri = 'https://go.microsoft.com/fwlink/?LinkID=217035')] param( [switch] ${UseBasicParsing}, [Parameter(Mandatory = $true, Position = 0)] [ValidateNotNullOrEmpty()] [uri] ${Uri}, [Microsoft.PowerShell.Commands.WebRequestSession] ${WebSession}, [Alias('SV')] [string] ${SessionVariable}, [switch] ${AllowUnencryptedAuthentication}, [Microsoft.PowerShell.Commands.WebAuthenticationType] ${Authentication}, [pscredential] [System.Management.Automation.CredentialAttribute()] ${Credential}, [switch] ${UseDefaultCredentials}, [ValidateNotNullOrEmpty()] [string] ${CertificateThumbprint}, [ValidateNotNull()] [X509Certificate] ${Certificate}, [switch] ${SkipCertificateCheck}, [Microsoft.PowerShell.Commands.WebSslProtocol] ${SslProtocol}, [securestring] ${Token}, [string] ${UserAgent}, [switch] ${DisableKeepAlive}, [ValidateRange(0, 2147483647)] [int32] ${TimeoutSec}, [System.Collections.IDictionary] ${Headers}, [ValidateRange(0, 2147483647)] [int] ${MaximumRedirection}, [Parameter(ParameterSetName = 'StandardMethod')] [Parameter(ParameterSetName = 'StandardMethodNoProxy')] [Microsoft.PowerShell.Commands.WebRequestMethod] ${Method}, [Parameter(ParameterSetName = 'CustomMethod', Mandatory = $true)] [Parameter(ParameterSetName = 'CustomMethodNoProxy', Mandatory = $true)] [Alias('CM')] [ValidateNotNullOrEmpty()] [string] ${CustomMethod}, [Parameter(ParameterSetName = 'CustomMethodNoProxy', Mandatory = $true)] [Parameter(ParameterSetName = 'StandardMethodNoProxy', Mandatory = $true)] [switch] ${NoProxy}, [Parameter(ParameterSetName = 'StandardMethod')] [Parameter(ParameterSetName = 'CustomMethod')] [uri] ${Proxy}, [Parameter(ParameterSetName = 'StandardMethod')] [Parameter(ParameterSetName = 'CustomMethod')] [pscredential] [System.Management.Automation.CredentialAttribute()] ${ProxyCredential}, [Parameter(ParameterSetName = 'StandardMethod')] [Parameter(ParameterSetName = 'CustomMethod')] [switch] ${ProxyUseDefaultCredentials}, [Parameter(ValueFromPipeline = $true)] [System.Object] ${Body}, [string] ${ContentType}, [ValidateSet('chunked', 'compress', 'deflate', 'gzip', 'identity')] [string] ${TransferEncoding}, [string] ${InFile}, [string] ${OutFile}, [switch] ${PassThru}, [switch] ${PreserveAuthorizationOnRedirect}, [switch] ${SkipHeaderValidation}) begin { if ($Credential -and (-not ($Authentication))) { $PSBoundParameters["Authentication"] = "Basic" } if ($InFile) { $multipartContent = [System.Net.Http.MultipartFormDataContent]::new() $FileStream = [System.IO.FileStream]::new($InFile, [System.IO.FileMode]::Open) $fileHeader = [System.Net.Http.Headers.ContentDispositionHeaderValue]::new("form-data") $fileHeader.Name = "file" $fileHeader.FileName = ([System.io.FileInfo]$InFile).name $fileContent = [System.Net.Http.StreamContent]::new($FileStream) $fileContent.Headers.ContentDisposition = $fileHeader $fileContent.Headers.ContentType = [System.Net.Http.Headers.MediaTypeHeaderValue]::Parse("application/octet-stream") $multipartContent.Add($fileContent) $PSBoundParameters["Headers"]['X-Atlassian-Token'] = 'nocheck' $PSBoundParameters["Body"] = $multipartContent $null = $PSBoundParameters.Remove("InFile") } try { $outBuffer = $null if ($PSBoundParameters.TryGetValue('OutBuffer', [ref]$outBuffer)) { $PSBoundParameters['OutBuffer'] = 1 } $wrappedCmd = $ExecutionContext.InvokeCommand.GetCommand('Microsoft.PowerShell.Utility\Invoke-WebRequest', [System.Management.Automation.CommandTypes]::Cmdlet) $scriptCmd = { & $wrappedCmd @PSBoundParameters } $steppablePipeline = $scriptCmd.GetSteppablePipeline($myInvocation.CommandOrigin) $steppablePipeline.Begin($PSCmdlet) } catch { throw } } process { try { $steppablePipeline.Process($_) if ($SessionVariable) { Set-Variable -Name $SessionVariable -Value (Get-Variable $SessionVariable).Value -Scope 1 } } catch { throw } } end { try { $steppablePipeline.End() } catch { throw } } } } #endregion Invoke-WebRequest #region Save-Configuration function Save-Configuration { [CmdletBinding()] param() begin { Write-Verbose "Function started" Import-MqcnAlias -Alias "ExportConfiguration" -Command "Configuration\Export-Configuration" $configuration = Get-Configuration -AsHashtable $export = @{} foreach ($key in $configuration.Keys) { $export[$key] = $configuration[$key] } $serverList = [System.Collections.Generic.List[AtlassianPS.ServerData]]::new() foreach ($server in @($export["ServerList"])) { if (-not $server) { continue } $serverData = [AtlassianPS.ServerData]@{ Id = $server.Id Name = $server.Name Uri = $server.Uri Type = $server.Type Certificate = $server.Certificate Headers = if ($server.Headers) { $server.Headers.Clone() } else { $null } } $serverList.Add($serverData) } $export["ServerList"] = $serverList ExportConfiguration -InputObject $export 3>$null Write-Verbose "Function ended" } } #endregion Save-Configuration #region Format-MessageStyle function Format-MessageStyle { [CmdletBinding()] [OutputType([String])] param( [Parameter(Mandatory, ValueFromPipeline)] [AllowEmptyString()] [String] $Message, [Parameter()] [AllowNull()] [System.Management.Automation.PSCmdlet] $Cmdlet, [Parameter()] [AllowNull()] [AtlassianPS.MessageStyle] $MessageSettings = $script:Configuration["Message"] ) process { if (-not $MessageSettings) { $MessageSettings = [AtlassianPS.MessageStyle]::new() } $indent, $functionName, $timeStamp = "" if ($MessageSettings.BreadCrumbs) { "[$((Get-BreadCrumb) -replace '^Format-MessageStyle > ', '')]:" if ($MessageSettings.Indent) { $indent = " " * $MessageSettings.Indent } else { $indent = " " * 4 } } elseif ($MessageSettings.FunctionName -and $Cmdlet) { $functionName = "[$($Cmdlet.MyInvocation.MyCommand.Name)] " } if ($MessageSettings.TimeStamp) { $timeStamp = "[$(Get-Date -Format "HH:mm:ss")] " } "{0}{1}{2}{3}" -f $timeStamp, $functionName, $indent, $Message } } #endregion Format-MessageStyle #region Import-HttpUtility function Import-HttpUtility { [CmdletBinding()] param() if ('System.Web.HttpUtility' -as [Type]) { return } if ($PSVersionTable.PSEdition -eq 'Desktop') { Add-Type -AssemblyName System.Web -ErrorAction Stop } else { Add-Type -AssemblyName System.Web.HttpUtility -ErrorAction Stop } } #endregion Import-HttpUtility #region New-ErrorRecord function New-ErrorRecord { [System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseShouldProcessForStateChangingFunctions', '')] [CmdletBinding()] [OutputType([System.Management.Automation.ErrorRecord])] param( [Parameter(Mandatory)] [ValidateSet('ExistingException', 'NewException')] [String] $Mode, [Parameter()] [System.Exception] $Exception, [Parameter()] [ValidateNotNullOrEmpty()] [String] $ExceptionType = 'System.Management.Automation.RuntimeException', [Parameter()] [String] $Message, [Parameter(Mandatory)] [ValidateNotNullOrEmpty()] [String] $ErrorId, [Parameter(Mandatory)] [ValidateNotNull()] [System.Management.Automation.ErrorCategory] $Category, [Parameter()] [Object] $TargetObject ) if ($Mode -eq 'NewException') { if (-not $Message) { throw 'Message is required when creating a new exception.' } if ($Exception) { $Exception = New-Object -TypeName $ExceptionType -ArgumentList $Message, $Exception } else { $Exception = New-Object -TypeName $ExceptionType -ArgumentList $Message } } if (-not $Exception) { throw 'Exception is required when creating an error record from an existing exception.' } return [System.Management.Automation.ErrorRecord]::new($Exception, $ErrorId, $Category, $TargetObject) } #endregion New-ErrorRecord #region Resolve-FullPath function Resolve-FullPath { # .ExternalHelp ..\AtlassianPS.Configuration-help.xml [CmdletBinding()] [OutputType([String])] param( [Parameter(Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName)] [ValidateNotNullOrEmpty()] [ValidateScript( { if (-not (Test-Path $_ -PathType Leaf)) { $errorItem = [System.Management.Automation.ErrorRecord]::new( ([System.ArgumentException]'File not found'), 'ParameterValue.FileNotFound', [System.Management.Automation.ErrorCategory]::ObjectNotFound, $_ ) $errorItem.ErrorDetails = "No file could be found with the provided path '$_'." $PSCmdlet.ThrowTerminatingError($errorItem) } else { return $true } } )] [Alias('FullName', 'PSPath')] [String] $Path ) process { $PSCmdlet.GetUnresolvedProviderPathFromPSPath($Path) } } #endregion Resolve-FullPath #region ThrowError function ThrowError { <# .SYNOPSIS Utility to throw a terminating errorrecord .NOTES Thanks to Jaykul: https://github.com/PoshCode/Configuration/blob/master/Source/Metadata.psm1 #> param ( [Parameter()] [ValidateNotNullOrEmpty()] [System.Management.Automation.PSCmdlet] $Cmdlet = $((Get-Variable -Scope 1 PSCmdlet).Value), [Parameter(Mandatory = $true, ParameterSetName = "ExistingException", Position = 1, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true)] [Parameter(ParameterSetName = "NewException")] [ValidateNotNullOrEmpty()] [System.Exception] $Exception, [Parameter(ParameterSetName = "NewException", Position = 2)] [ValidateNotNullOrEmpty()] [System.String] $ExceptionType = "System.Management.Automation.RuntimeException", [Parameter(Mandatory = $true, ParameterSetName = "NewException", Position = 3)] [ValidateNotNullOrEmpty()] [System.String] $Message, [Parameter(Mandatory = $false)] [System.Object] $TargetObject, [Parameter(Mandatory = $true, ParameterSetName = "ExistingException", Position = 10)] [Parameter(Mandatory = $true, ParameterSetName = "NewException", Position = 10)] [ValidateNotNullOrEmpty()] [System.String] $ErrorId, [Parameter(Mandatory = $true, ParameterSetName = "ExistingException", Position = 11)] [Parameter(Mandatory = $true, ParameterSetName = "NewException", Position = 11)] [ValidateNotNull()] [System.Management.Automation.ErrorCategory] $Category, [Parameter(Mandatory = $true, ParameterSetName = "Rethrow", Position = 1)] [System.Management.Automation.ErrorRecord]$ErrorRecord ) process { if (!$ErrorRecord) { if ($PSCmdlet.ParameterSetName -eq "NewException") { if ($Exception) { $Exception = New-Object $ExceptionType $Message, $Exception } else { $Exception = New-Object $ExceptionType $Message } } $errorRecord = New-Object System.Management.Automation.ErrorRecord $Exception, $ErrorId, $Category, $TargetObject } $Cmdlet.ThrowTerminatingError($errorRecord) } } #endregion ThrowError #region Write-Verbose function Write-Verbose { <# .SYNOPSIS Write a verbose message .DESCRIPTION Write a verbose message This function allows the user to decide how the Verbose Message should be formatted. The configuration is inside `$scrpit:Configuration` and supports the following structure (json representation): { "message": { // show a line with the Bread Crumbs of the caller stack "breadcrumbs": true, // how many whitespaces should be used for indenting the // message "indent": true, // show the name of the calling function - this is ignored // if breadcrumbs is active "functionname": true, // show the timestamp (HH:mm:ss format) of the message "timestamp": true } } .EXAMPLE Write-DebugMessage "The value of `$var is: $var" ---------- Description Shows the message if the user added `-Debug` to the command but does not create a breakpoint #> [CmdletBinding()] param( [Parameter( Mandatory, ValueFromPipeline )] [String] $Message, [Parameter()] [ValidateNotNullOrEmpty()] [System.Management.Automation.PSCmdlet] $Cmdlet = ((Get-Variable -Scope 1 PSCmdlet).Value) ) begin { $indent, $functionName, $timeStamp = "" Import-MqcnAlias -Alias "WriteVerbose" -Command "Microsoft.PowerShell.Utility\Write-Verbose" $messageSettings = $script:Configuration["Message"] } process { if ((Get-PSCallstack | Select-Object -Last 1 -Skip 1).Arguments.Contains("Verbose")) { $VerbosePreference = 'Continue' } if ($messageSettings.Breadcrumbs) { WriteVerbose "[$(Get-BreadCrumb)]:" if ($messageSettings.Indent) { $indent = " " * $messageSettings.Indent } else { $indent = " " * 4 } } else { if ($messageSettings.FunctionName) { $functionName = "[$($Cmdlet.MyInvocation.MyCommand.Name)] " } } if ($messageSettings.Timestamp) { $timeStamp = "[$(Get-Date -f "HH:mm:ss")] " } WriteVerbose ("{0}{1}{2}{3}" -f $timeStamp, $functionName, $indent, $Message) } } #endregion Write-Verbose #region WriteError function WriteError { <# .SYNOPSIS Utility to write an errorrecord to the errstd .NOTES Thanks to Jaykul: https://github.com/PoshCode/Configuration/blob/master/Source/Metadata.psm1 #> param ( [Parameter()] [ValidateNotNullOrEmpty()] [System.Management.Automation.PSCmdlet] $Cmdlet = $((Get-Variable -Scope 1 PSCmdlet).Value), [Parameter(Mandatory = $true, ParameterSetName = "ExistingException", Position = 1, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true)] [Parameter(ParameterSetName = "NewException")] [ValidateNotNullOrEmpty()] [System.Exception] $Exception, [Parameter(ParameterSetName = "NewException", Position = 2)] [ValidateNotNullOrEmpty()] [System.String] $ExceptionType = "System.Management.Automation.RuntimeException", [Parameter(Mandatory = $true, ParameterSetName = "NewException", Position = 3)] [ValidateNotNullOrEmpty()] [System.String] $Message, [Parameter(Mandatory = $false)] [System.Object] $TargetObject, [Parameter(Mandatory = $true, Position = 10)] [ValidateNotNullOrEmpty()] [System.String] $ErrorId, [Parameter(Mandatory = $true, Position = 11)] [ValidateNotNull()] [System.Management.Automation.ErrorCategory] $Category, [Parameter(Mandatory = $true, ParameterSetName = "Rethrow", Position = 1)] [System.Management.Automation.ErrorRecord]$ErrorRecord ) process { if (!$ErrorRecord) { if ($PSCmdlet.ParameterSetName -eq "NewException") { if ($Exception) { $Exception = New-Object $ExceptionType $Message, $Exception } else { $Exception = New-Object $ExceptionType $Message } } $errorRecord = New-Object System.Management.Automation.ErrorRecord $Exception, $ErrorId, $Category, $TargetObject } $Cmdlet.WriteError($errorRecord) } } #endregion WriteError #endregion LoadFunctions # Load configuration using # https://github.com/PoshCode/Configuration [Hashtable]$script:Configuration = Import-Configuration -CompanyName "AtlassianPS" -Name "AtlassianPS.Configuration" if (-not $script:Configuration) { $script:Configuration = @{} } if (-not $script:Configuration.ContainsKey("ServerList")) { $script:Configuration.Add("ServerList", [System.Collections.Generic.List[AtlassianPS.ServerData]]::new()) } #endregion ModuleConfig |