Partager via


Remove-AzPolicyExemption

Cette opération supprime une exemption de stratégie, en fonction de son nom et de l’étendue dans laquelle elle a été créée. L’étendue d’une exemption de stratégie fait partie de son ID précédent « /providers/Microsoft.Authorization/policyExemptions/{policyExemptionName} ».

Syntax

Remove-AzPolicyExemption
      -Name <String>
      [-Scope <String>]
      [-Force]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPolicyExemption
      -Id <String>
      [-Force]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPolicyExemption
      -InputObject <IPolicyIdentity>
      [-Force]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-PassThru]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Cette opération supprime une exemption de stratégie, en fonction de son nom et de l’étendue dans laquelle elle a été créée. L’étendue d’une exemption de stratégie fait partie de son ID précédent « /providers/Microsoft.Authorization/policyExemptions/{policyExemptionName} ».

Exemples

Exemple 1 : Supprimer l’exemption de stratégie par nom et étendue

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Remove-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId -Confirm

La première commande obtient un groupe de ressources nommé ResourceGroup11 à l’aide de l’applet de commande Get-AzResourceGroup. La commande stocke cet objet dans la variable $ResourceGroup. La deuxième commande supprime l’exemption de stratégie nommée PolicyExemption07 qui a été affectée au niveau d’un groupe de ressources. La propriété ResourceId de $ResourceGroup identifie le groupe de ressources.

Exemple 2 : Supprimer l’exemption de stratégie par ID

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11' 
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId
Remove-AzPolicyExemption -Id $PolicyExemption.ResourceId -Confirm

La première commande obtient un groupe de ressources nommé ResourceGroup11, puis stocke cet objet dans la variable $ResourceGroup. La deuxième commande obtient l’exemption de stratégie au niveau d’un groupe de ressources, puis la stocke dans la variable $PolicyExemption. La propriété ResourceId de $ResourceGroup identifie le groupe de ressources. La commande finale supprime l’exemption de stratégie que la propriété ResourceId de $PolicyExemption identifie.

Exemple 3 : [Backcompat] Supprimer l’exemption de stratégie par ID

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11' 
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId
Remove-AzPolicyExemption -Id $PolicyExemption.ResourceId -Force -BackwardCompatible
True

La première commande obtient un groupe de ressources nommé ResourceGroup11, puis stocke cet objet dans la variable $ResourceGroup. La deuxième commande obtient l’exemption de stratégie au niveau d’un groupe de ressources, puis la stocke dans la variable $PolicyExemption. La propriété ResourceId de $ResourceGroup identifie le groupe de ressources. La commande finale supprime l’exemption de stratégie que la propriété ResourceId de $PolicyExemption identifie.

Paramètres

-BackwardCompatible

Provoque le retour d’artefacts à l’aide d’un format hérité plaçant des propriétés propres à une stratégie dans un objet de conteneur de propriétés.

Type:SwitchParameter
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Le paramètre DefaultProfile n’est pas fonctionnel. Utilisez le paramètre SubscriptionId lorsqu’il est disponible si vous exécutez l’applet de commande sur un autre abonnement.

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Quand $true, ignorez les invites de confirmation

Type:SwitchParameter
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

ID de l’exemption de stratégie à supprimer. Utilisez le format « {scope}/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName} ».

Type:String
Aliases:ResourceId, PolicyExemptionId
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

Type:IPolicyIdentity
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Nom de l’exemption de stratégie à supprimer.

Type:String
Aliases:PolicyExemptionName
Position:Named
valeur par défaut:None
Obligatoire:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Retourne true lorsque la commande réussit

Type:SwitchParameter
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Étendue de l’exemption de stratégie. Les étendues valides sont les suivantes : groupe d’administration (format : '/providers/Microsoft.Management/managementGroups/{managementGroup}'), abonnement (format : '/subscriptions/{subscriptionId}'), groupe de ressources (format : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', ou ressource (format : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

Type:String
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
valeur par défaut:None
Obligatoire:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

IPolicyIdentity

String

Sorties

Boolean