Functions/User/New-PASGroup.ps1
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 |
# .ExternalHelp psPAS-help.xml function New-PASGroup { [CmdletBinding(SupportsShouldProcess)] param( [parameter( Mandatory = $true, ValueFromPipelinebyPropertyName = $true )] [string]$groupName, [parameter( Mandatory = $false, ValueFromPipelinebyPropertyName = $true )] [string]$description, [parameter( Mandatory = $false, ValueFromPipelinebyPropertyName = $true )] [string]$location ) BEGIN { Assert-VersionRequirement -RequiredVersion 11.1 }#begin PROCESS { #Create URL for request $URI = "$Script:BaseURI/API/UserGroups" #Construct Request Body $Body = $PSBoundParameters | Get-PASParameter | ConvertTo-Json if ($PSCmdlet.ShouldProcess($groupName, 'Create Group')) { #send request to web service $result = Invoke-PASRestMethod -Uri $URI -Method POST -Body $Body -WebSession $Script:WebSession } If ($null -ne $result) { $result | Add-ObjectDetail -typename psPAS.CyberArk.Vault.Group } }#process END { }#end } |