Partager via


Get-AzPolicyExemption

Obtient des exemptions de stratégie.

Syntaxe

Get-AzPolicyExemption
   [-Name <String>]
   [-Scope <String>]
   [-PolicyAssignmentIdFilter <String>]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicyExemption
   [-Scope <String>]
   [-IncludeDescendent]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicyExemption
   [-PolicyAssignmentIdFilter <String>]
   -Id <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Description

L’applet de commande Get-AzPolicyExemption obtient une collection d’exemptions de stratégie ou une exemption de stratégie spécifique identifiée par nom ou ID.

Exemples

Exemple 1 Obtenir toutes les exemptions de stratégie

Get-AzPolicyExemption

Cette commande obtient toutes les exemptions de stratégie dans l’abonnement actuel. Si vous devez répertorier toutes les exemptions liées à l’étendue donnée, y compris celles des étendues ancêtres et celles des étendues descendantes, vous devez passer le -IncludeDescendent paramètre.

Exemple 2 : Obtenir une exemption de stratégie spécifique

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

La première commande obtient un groupe de ressources nommé ResourceGroup11 à l’aide de l’applet de commande Get-AzResourceGroup et le stocke dans la variable $ResourceGroup. La deuxième commande obtient l’exemption de stratégie nommée PolicyExemption07 pour l’étendue que la propriété ResourceId de $ResourceGroup identifie.

Exemple 3 : Obtenir toutes les exemptions de stratégie associées à une attribution de stratégie

$Assignment = Get-AzPolicyAssignment -Name 'PolicyAssignment07'
Get-AzPolicyExemption -PolicyAssignmentIdFilter $Assignment.ResourceId

La première commande obtient une attribution de stratégie nommée PolicyAssignment07. La deuxième commande obtient toutes les exemptions de stratégie affectées à l’attribution de stratégie.

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
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Alias:AzureRMContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Id

ID de ressource complet de l’exemption.

Type:String
Alias:ResourceId
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-IncludeDescendent

Provoque la liste des exemptions de stratégie retournées pour inclure toutes les exemptions liées à l’étendue donnée, y compris celles provenant d’étendues ancêtres et celles provenant d’étendues descendantes. S’il n’est pas fourni, seules les exemptions au-dessus de l’étendue donnée sont incluses.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Nom de l’exemption de stratégie.

Type:String
Alias:PolicyExemptionName
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PolicyAssignmentIdFilter

Filtre d’ID d’affectation de stratégie.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

SwitchParameter

String

Sorties

IPolicyExemption