Add-PASSafe.ps1

# .ExternalHelp psPAS-help.xml
function Add-PASSafe {
	[CmdletBinding(DefaultParameterSetName = 'NumberOfVersionsRetention')]
	param(
		[parameter(
			Mandatory = $true,
			ValueFromPipelinebyPropertyName = $true
		)]
		[ValidateNotNullOrEmpty()]
		[ValidateScript( { $_ -notmatch ".*(\\|\/|:|\*|<|>|`"|\.|\||^\s).*" })]
		[ValidateLength(0, 28)]
		[string]$SafeName,

		[parameter(
			Mandatory = $false,
			ValueFromPipelinebyPropertyName = $true
		)]
		[ValidateLength(0, 100)]
		[string]$Description,

		[parameter(
			Mandatory = $false,
			ValueFromPipelinebyPropertyName = $true
		)]
		[string]$location,

		[parameter(
			Mandatory = $false,
			ValueFromPipelinebyPropertyName = $true
		)]
		[boolean]$OLACEnabled,

		[parameter(
			Mandatory = $false,
			ValueFromPipelinebyPropertyName = $true
		)]
		[string]$ManagingCPM,

		[parameter(
			Mandatory = $true,
			ValueFromPipelinebyPropertyName = $true,
			ParameterSetName = 'Gen1-NumberOfVersionsRetention'
		)]
		[parameter(
			Mandatory = $true,
			ValueFromPipelinebyPropertyName = $true,
			ParameterSetName = 'NumberOfVersionsRetention'
		)]
		[ValidateRange(1, 999)]
		[int]$NumberOfVersionsRetention,

		[parameter(
			Mandatory = $true,
			ValueFromPipelinebyPropertyName = $true,
			ParameterSetName = 'Gen1-NumberOfDaysRetention'
		)]
		[parameter(
			Mandatory = $true,
			ValueFromPipelinebyPropertyName = $true,
			ParameterSetName = 'NumberOfDaysRetention'
		)]
		[ValidateRange(0, 3650)]
		[int]$NumberOfDaysRetention,

		[parameter(
			Mandatory = $false,
			ValueFromPipelinebyPropertyName = $true,
			ParameterSetName = 'NumberOfVersionsRetention'
		)]
		[parameter(
			Mandatory = $false,
			ValueFromPipelinebyPropertyName = $true,
			ParameterSetName = 'NumberOfDaysRetention'
		)]
		[boolean]$AutoPurgeEnabled,

		[parameter(
			Mandatory = $true,
			ValueFromPipelinebyPropertyName = $true,
			ParameterSetName = 'Gen1-NumberOfVersionsRetention'
		)]
		[parameter(
			Mandatory = $true,
			ValueFromPipelinebyPropertyName = $true,
			ParameterSetName = 'Gen1-NumberOfDaysRetention'
		)]
		[switch]$UseGen1API
	)

	BEGIN {
		$typename = 'psPAS.CyberArk.Vault.Safe'
	}#begin

	PROCESS {

		switch ($PSCmdlet.ParameterSetName) {

			( { $PSItem -match '^Gen1-' } ) {

				#Create URL for request
				$URI = "$($psPASSession.BaseURI)/WebServices/PIMServices.svc/Safes"

				#create request body
				$body = @{

					#add parameters to safe node
					'safe' = $PSBoundParameters | Get-PASParameter

				} | ConvertTo-Json

				break

			}

			default {

				Assert-VersionRequirement -RequiredVersion 12.0

				#Create URL for request
				$URI = "$($psPASSession.BaseURI)/API/Safes"

				$typename = "$typename.Gen2"

				$body = $PSBoundParameters | Get-PASParameter | ConvertTo-Json

				break

			}

		}

		#send request to web service
		$result = Invoke-PASRestMethod -Uri $URI -Method POST -Body $Body

		If ($null -ne $result) {

			switch ($PSCmdlet.ParameterSetName) {

				( { $PSItem -match '^Gen1-' } ) {

					$return = $result.AddSafeResult

					break

				}

				default {

					$return = $result

					break

				}

			}

			$return | Add-ObjectDetail -typename $typename
		}

	}#process

	END { }#end

}