Functions/Safes/Get-PVSafeFileCategory.ps1
|
Function Get-PVSafeFileCategory { <# .SYNOPSIS Lists all the File Categories that are available in the specified Safe .DESCRIPTION Exposes the PACLI Function: "LISTSAFEFILECATEGORIES" .PARAMETER vault The defined Vault name .PARAMETER user The Username of the authenticated User. .PARAMETER safe The Safe where the File Categories is defined. .PARAMETER category The name of the File Category to list. .PARAMETER sessionID The ID number of the session. Use this parameter when working with multiple scripts simultaneously. The default is ‘0’. .EXAMPLE Get-PVSafeFileCategory -vault lab -user administrator -safe ORACLE -category CISOcat1 lists specific file category details .EXAMPLE Get-PVSafeFileCategory -vault lab -user administrator -safe ORACLE lists all file category details .NOTES AUTHOR: Pete Maan #> [CmdLetBinding()] param( [Parameter( Mandatory = $True, ValueFromPipelineByPropertyName = $True)] [string]$vault, [Parameter( Mandatory = $True, ValueFromPipelineByPropertyName = $True)] [string]$user, [Parameter( Mandatory = $False, ValueFromPipelineByPropertyName = $True)] [Alias("Safename")] [string]$safe, [Parameter( Mandatory = $False, ValueFromPipelineByPropertyName = $True)] [string]$category, [Parameter( Mandatory = $False, ValueFromPipelineByPropertyName = $True)] [int]$sessionID ) PROCESS { $Return = Invoke-PACLICommand $Script:PV.ClientPath LISTSAFEFILECATEGORIES "$($PSBoundParameters.getEnumerator() | ConvertTo-ParameterString) output (ALL,ENCLOSE)" #if result(s) returned if($Return.StdOut) { #Convert Output to array $Results = (($Return.StdOut | Select-String -Pattern "\S") | ConvertFrom-PacliOutput) #loop through results For($i = 0 ; $i -lt $Results.length ; $i += 7) { #Get Range from array $values = $Results[$i..($i + 7)] #Output Object [PSCustomObject] @{ "CategoryID" = $values[0] "CategoryName" = $values[1] "CategoryType" = $values[2] "CategoryValidValues" = $values[3] "CategoryDefaultValue" = $values[4] "CategoryRequired" = $values[5] "VaultCategory" = $values[6] } | Add-ObjectDetail -TypeName pacli.PoShPACLI.Safe.FileCategory -PropertyToAdd @{ "vault" = $vault "user" = $user "sessionID" = $sessionID } } } } } |