Functions/Get-PARComponentConfig.ps1
|
Function Get-PARComponentConfig { <# .SYNOPSIS Gets values set in component configuration files .DESCRIPTION Queries remote vault server for values contained in component configuration files DBPARM.ini or PADR.ini. .PARAMETER Server The name or address of the remote Vault server to target with PARClient .PARAMETER Password The password for remote operations via PARClient as a secure string .PARAMETER Credential The password for remote operations via PARClient held in a credential object .PARAMETER PassFile The path to a "password" file created by PARClient.exe, containing the encrypted password value used for remote operations via PARClient .PARAMETER Component The name of the component to query. Vault or PADR are the accepted values .PARAMETER Parameter The name of the Parameter to get the value of. For Vault Components, the valid parameter names are: "DefaultTimeout", "MTU", "SecurityNotification", "DebugLevel", "DisableExceptionHandling" For Disaster Recovery Components, the valid parameter names are: "EnableCheck", "EnableReplicate", "EnableFailover", "EnableDBSync", "FailoverMode" .EXAMPLE Get-PARComponentConfig -Server EPV1 -Credential $credential -Component Vault -Parameter DebugLevel Returns the DebugLevel parameter value configured in the dbparm.ini file on vault server EPV1 #> [CmdletBinding()] Param( [Parameter( Mandatory = $true, ValueFromPipelineByPropertyName = $true )] [string]$Server, [Parameter( Mandatory = $true, ValueFromPipelineByPropertyName = $true, ParameterSetName = "Password" )] [securestring]$Password, [Parameter( Mandatory = $true, ValueFromPipelineByPropertyName = $true, ParameterSetName = "Credential" )] [pscredential]$Credential, [Parameter( Mandatory = $True, ValueFromPipelineByPropertyName = $True, ParameterSetName = "PassFile" )] [string]$PassFile, [Parameter( Mandatory = $true, ValueFromPipelineByPropertyName = $true )] [ValidateSet("Vault", "PADR")] [string]$Component, [Parameter( Mandatory = $true, ValueFromPipelineByPropertyName = $true )] [ValidateSet("DefaultTimeout", "MTU", "SecurityNotification", "DebugLevel", "DisableExceptionHandling", "EnableCheck", "EnableReplicate", "EnableFailover", "EnableDBSync", "FailoverMode")] [string]$Parameter ) Begin { $VaultSet = "DefaultTimeout", "MTU", "SecurityNotification", "DebugLevel", "DisableExceptionHandling" $PADRSet = "EnableCheck", "EnableReplicate", "EnableFailover", "EnableDBSync", "FailoverMode" } Process { Switch($Component) { "Vault" { If($VaultSet -notcontains $Parameter) {throw "Not a valid DBPARM.ini Parameter"} } "PADR" { If($PADRSet -notcontains $Parameter) {throw "Not a valid PADR.ini Parameter"} } } $PSBoundParameters.Add("CommandParameters", "GetParm $Component $($PSBoundParameters["Parameter"])") $Result = Invoke-PARClient @PSBoundParameters If($Result.StdOut) { If($Result.StdOut -match "=") { $Value = ($Result.StdOut).Split("=")[1] } Else {$Value = $Result.StdOut} [PSCustomObject]@{ "Server" = $Result.Server "Component" = $Component "Parameter" = $($PSBoundParameters["Parameter"]) "Value" = $Value.Trim() } } } } |