Public/New-TppCodeSignProject.ps1
|
<# .SYNOPSIS Create a new code sign project .DESCRIPTION Create a new code sign project which will be empty. .PARAMETER Path Path of the project to create .PARAMETER VenafiSession Authentication for the function. The value defaults to the script session object $VenafiSession created by New-VenafiSession. A TPP token or VaaS key can also provided. If providing a TPP token, an environment variable named TppServer must also be set. .INPUTS Path .OUTPUTS PSCustomObject with the following properties: Application Auditor CertificateEnvironments Collection CreatedOn Guid Id KeyUseApprovers KeyUsers Owners Status Name Path TypeName .EXAMPLE New-TppCodeSignProject -Path '\ved\code signing\projects\my_project' Create a new code sign project .LINK http://VenafiPS.readthedocs.io/en/latest/functions/New-TppCodeSignProject/ .LINK https://github.com/Venafi/VenafiPS/blob/main/VenafiPS/Public/New-TppCodeSignProject.ps1 .LINK https://docs.venafi.com/Docs/current/TopNav/Content/SDK/CodeSignSDK/r-SDKc-POST-Codesign-CreateProject.php #> function New-TppCodeSignProject { [CmdletBinding(SupportsShouldProcess)] param ( [Parameter(Mandatory, ValueFromPipeline)] [ValidateNotNullOrEmpty()] [ValidateScript( { if ( $_ | Test-TppDnPath ) { $true } else { throw "'$_' is not a valid path" } })] [String] $Path, [Parameter()] [psobject] $VenafiSession = $script:VenafiSession ) begin { Test-VenafiSession -VenafiSession $VenafiSession -Platform 'TPP' -AuthType 'token' $params = @{ VenafiSession = $VenafiSession Method = 'Post' UriLeaf = 'Codesign/CreateProject' Body = @{ } } } process { $params.Body.Dn = $Path if ( $PSCmdlet.ShouldProcess($Path, 'New code sign project') ) { $response = Invoke-VenafiRestMethod @params if ( $response.Success ) { $response.Project | ConvertTo-TppCodeSignProject } else { Write-Error ('{0} : {1} : {2}' -f $response.Result, [enum]::GetName([TppCodeSignResult], $response.Result), $response.Error) } } } } |