public/New-VSATenantRoleType.ps1
|
function New-VSATenantRoleType { <# .Synopsis Adds a roletype. .DESCRIPTION Creates a new roletype. Takes either persistent or non-persistent connection information. .PARAMETER VSAConnection Specifies existing non-persistent VSAConnection. .PARAMETER URISuffix Specifies URI suffix if it differs from the default. .PARAMETER Name Specifies the Role Name. .PARAMETER Description Specifies the Role Description. .PARAMETER AdminGroupType Specifies Id of Admin Group Type. .PARAMETER HasUserData Specifies if Has User Data. .PARAMETER Status Specifies the status to assign to the role type. .EXAMPLE New-VSATenantRoleType -Name 'A New Role' .EXAMPLE New-VSATenantRoleType -Name 'A New Role' -VSAConnection $connection .INPUTS Accepts piped non-persistent VSAConnection .OUTPUTS True if creation was successful. #> [CmdletBinding(SupportsShouldProcess)] [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSShouldProcess', '', Justification = 'ShouldProcess is invoked centrally by Invoke-VSAWriteRequest, which receives this cmdlet''s $PSCmdlet via -Caller (module-wide pattern).')] param ( [parameter(Mandatory = $false, ValueFromPipelineByPropertyName = $true)] [ValidateNotNull()] [VSAConnection] $VSAConnection, [parameter(DontShow, Mandatory=$false)] [ValidateNotNullOrEmpty()] [string] $URISuffix = 'api/v1.0/tenantmanagement/roletypes', [Parameter(Mandatory = $true, ValueFromPipelineByPropertyName = $true)] [ValidateNotNullOrEmpty()] [string] $Name, [Parameter(Mandatory = $false, ValueFromPipelineByPropertyName = $true)] [ValidateScript({ if( (-not [string]::IsNullOrEmpty($_)) -and ($_ -notmatch "^\d+$") ) { throw "Non-numeric value" } return $true })] [string] $Status, [Parameter(Mandatory = $false, ValueFromPipelineByPropertyName = $true)] [ValidateNotNullOrEmpty()] [string] $Description, [Parameter(Mandatory = $false, ValueFromPipelineByPropertyName = $true)] [ValidateScript({ if( (-not [string]::IsNullOrEmpty($_)) -and ($_ -notmatch "^\d+$") ) { throw "Non-numeric Id" } return $true })] [string] $AdminGroupType, [Parameter(Mandatory = $false, ValueFromPipelineByPropertyName = $true)] [ValidateSet("Y", "N")] [string] $HasUserData ) process { [hashtable] $AuxParameters = @{} if($VSAConnection) {$AuxParameters.Add('VSAConnection', $VSAConnection)} [int] $Zzvalsid = try {(Get-VSATenantRoletypesFunclists @AuxParameters | Select-Object -ExpandProperty Zzvalsid | Measure-Object -Maximum | Select-Object -ExpandProperty Maximum) + 1} catch {throw $_} [string] $Zzvals = "zzvals$Zzvalsid" $BodyHT = [ordered] @{ Name = $Name Zzvalsid = $Zzvalsid Zzvals = $Zzvals } if ( -not [string]::IsNullOrEmpty($Status)) {$BodyHT.Add('Status', $Status) } if ( -not [string]::IsNullOrEmpty($Description)) {$BodyHT.Add('Description', $Description) } if ( -not [string]::IsNullOrEmpty($AdminGroupType)) {$BodyHT.Add('AdminGroupType', $AdminGroupType) } if ( -not [string]::IsNullOrEmpty($HasUserData)) {$BodyHT.Add('HasUserData', $HasUserData) } [string]$Body = $BodyHT| ConvertTo-Json return Invoke-VSAWriteRequest -Body ($Body) -Method 'POST' -URISuffix ($URISuffix) -VSAConnection $VSAConnection -Caller $PSCmdlet } } New-Alias -Name Add-VSATenantRoleType -Value New-VSATenantRoleType Export-ModuleMember -Function New-VSATenantRoleType -Alias Add-VSATenantRoleType |