Scripts/ProtectionPolicy/Set-CohesityProtectionPolicy.ps1
|
function Set-CohesityProtectionPolicy { <# .SYNOPSIS Updates a Protection Policy. .DESCRIPTION Returns the updated Protection Policy. .NOTES Published by Cohesity .LINK https://cohesity.github.io/cohesity-powershell-module/#/README .EXAMPLE Set-CohesityProtectionPolicy -ProtectionPolicy $policy Updates a Protection Policy with the specified parameters. .EXAMPLE $result = Get-CohesityProtectionPolicy -Name Test-Policy $result.name = "Test-Policy-updated" $result | Set-CohesityProtectionPolicy #> [OutputType('System.Array')] [CmdletBinding(SupportsShouldProcess = $True, ConfirmImpact = "High")] Param( [Parameter(Mandatory = $true, ValueFromPipeline = $true)] # The updated Protection Policy object. [object]$ProtectionPolicy ) Begin { } Process { $protectionPolicyName = $ProtectionPolicy.name if ($PSCmdlet.ShouldProcess($protectionPolicyName)) { $url = '/irisservices/api/v1/public/protectionPolicies/' + $ProtectionPolicy.id $payloadJson = ($ProtectionPolicy | ConvertTo-Json -Depth 100) $resp = Invoke-RestApi -Method Put -Uri $url -Body $payloadJson if($resp) { # tagging reponse for display format ( configured in Cohesity.format.ps1xml ) @($resp | Add-Member -TypeName 'System.Object#ProtectionPolicy' -PassThru) } else { $errorMsg = "Protection Policy : $protectionPolicyName, Failed to update" Write-Output $errorMsg CSLog -Message $errorMsg } } } End { } } |