Remove-ProtectionPolicy
SYNOPSIS
Removes a protection policy.
SYNTAX
ByName (Default)
Remove-ProtectionPolicy [-Cluster] <Cluster> [-Name] <String[]> [-Confirm] [-Force] [-PassThru] [-WhatIf]
[<CommonParameters>]
ById
Remove-ProtectionPolicy [-Cluster] <Cluster> -Id <String[]> [-Confirm] [-Force] [-PassThru] [-WhatIf]
[<CommonParameters>]
DESCRIPTION
Removes one or more protection policies by name or Id. A policy cannot be removed if any storage resources are associated with the policy.
EXAMPLES
Example 1
PS C:\> Remove-ProtectionPolicy -Cluster $cluster -Name policy1
Where $cluster is a PowerStore cluster instance. Removes the protection policy named policy1.
Example 2
PS C:\> Remove-ProtectionPolicy -Cluster $cluster -Id policyId1
Where $cluster is a PowerStore cluster instance. Removes the protection policy with Id policyId1.
PARAMETERS
-Cluster
The PowerStore cluster instance.
Type: Cluster
Parameter Sets: (All)
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
The protection policy name.
Type: String[]
Parameter Sets: ByName
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-Id
The protection policy Id.
Type: String[]
Parameter Sets: ById
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Force
Suppress confirmation prompt before removing the protection policy.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Returns the protection policy instance that was removed.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.