Update-AzPolicyExemption

Module:

Az.Resources

Cette opération met à jour une exemption de stratégie avec l’étendue et le nom donnés.

Syntaxe

Update-AzPolicyExemption
      -Name <String>
      [-Scope <String>]
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-ResourceSelector <IResourceSelector[]>]
      [-AssignmentScopeValidation <String>]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzPolicyExemption
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      -Id <String>
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-ResourceSelector <IResourceSelector[]>]
      [-AssignmentScopeValidation <String>]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzPolicyExemption
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-ResourceSelector <IResourceSelector[]>]
      [-AssignmentScopeValidation <String>]
      [-BackwardCompatible]
      -InputObject <IPolicyExemption>
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Cette opération met à jour une exemption de stratégie avec l’étendue et le nom donnés.

Exemples

Exemple 1 : Mettre à jour le nom complet

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
 $PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId
Update-AzPolicyExemption -Id $PolicyExemption.ResourceId -DisplayName 'Exempt VM creation limit'

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 obtient l’exemption de stratégie nommée PolicyExemption07 à l’aide de l’applet de commande Get-AzPolicyExemption. La commande stocke cet objet dans la variable $PolicyExemption. La commande finale met à jour le nom complet de l’exemption de stratégie sur le groupe de ressources identifié par la propriété ResourceId ResourceId de $ResourceGroup.

Exemple 2 : Mettre à jour l’heure d’expiration

$NextMonth = (Get-Date).AddMonths(1)
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Update-AzPolicyExemption -Id $PolicyExemption.ResourceId -ExpiresOn $NextMonth

La première commande obtient l’heure de date actuelle à l’aide de l’applet de commande Get-Date et ajoutez 1 mois à l’heure de date actuelle. La commande stocke cet objet dans la variable $NextMonth. La deuxième commande obtient l’exemption de stratégie nommée PolicyExemption07 à l’aide de l’applet de commande Get-AzPolicyExemption. La commande stocke cet objet dans la variable $PolicyExemption. La commande finale met à jour la date d’expiration de l’exemption de stratégie sur l’abonnement par défaut.

Exemple 3 : Effacer l’heure d’expiration

$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Update-AzPolicyExemption -Id $PolicyExemption.ResourceId -ClearExpiration

La première commande obtient l’exemption de stratégie nommée PolicyExemption07 à l’aide de l’applet de commande Get-AzPolicyExemption. La commande stocke cet objet dans la variable $PolicyExemption. La deuxième commande efface la date d’expiration de l’exemption de stratégie sur l’abonnement par défaut. L’exemption mise à jour n’expirera jamais.

Exemple 4 : Mettre à jour la catégorie d’expiration

$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Update-AzPolicyExemption -Id $PolicyExemption.ResourceId -ExemptionCategory Mitigated

La première commande obtient l’exemption de stratégie nommée PolicyExemption07 à l’aide de l’applet de commande Get-AzPolicyExemption. La commande stocke cet objet dans la variable $PolicyExemption. La deuxième commande met à jour la catégorie d’expiration pour l’exemption de stratégie sur l’abonnement par défaut. L’exemption mise à jour n’expirera jamais.

La première commande obtient l’heure de date actuelle à l’aide de l’applet de commande Get-Date et ajoutez 1 mois à l’heure de date actuelle. La commande stocke cet objet dans la variable $NextMonth. La deuxième commande obtient l’exemption de stratégie nommée PolicyExemption07 à l’aide de l’applet de commande Get-AzPolicyExemption. La commande stocke cet objet dans la variable $PolicyExemption. La commande finale met à jour la date d’expiration de l’exemption de stratégie sur l’abonnement par défaut.

Exemple 5 : Mettre à jour le sélecteur de ressources

$ResourceSelector = @{Name = "MyLocationSelector"; Selector = @(@{Kind = "resourceLocation"; NotIn = @("eastus", "eastus2")})}
Update-AzPolicyExemption -Name 'VirtualMachineExemption' -ResourceSelector $ResourceSelector

La première commande crée un objet sélecteur de ressources qui sera utilisé pour spécifier l’exemption ne doit s’appliquer qu’aux ressources dans des emplacements autres que usa Est ou USA Est 2 et les stocke dans la variable $ResourceSelector. La commande finale met à jour l’exemption de stratégie nommée VirtualMachineExemption avec le sélecteur de ressources spécifié par $ResourceSelector.

Exemple 6 : [Backcompat] Effacer l’heure d’expiration

$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -ClearExpiration

La première commande obtient l’exemption de stratégie nommée PolicyExemption07 à l’aide de l’applet de commande Get-AzPolicyExemption. La commande stocke cet objet dans la variable $PolicyExemption. La deuxième commande efface la date d’expiration de l’exemption de stratégie sur l’abonnement par défaut. L’exemption mise à jour n’expirera jamais.

Paramètres

-AssignmentScopeValidation

Option indiquant si l’exemption est valide ou sous l’étendue de l’affectation.

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

-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

-ClearExpiration

Indique s’il faut effacer la date et l’heure d’expiration de l’exemption de stratégie.

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

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Alias:	cf
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

-Description

Ce message fait partie de la réponse en cas de violation 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

-DisplayName

Nom complet de l’attribution 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

-ExemptionCategory

Catégorie d’exemption 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

-ExpiresOn

Date et heure d’expiration (au format UTC ISO 8601 aaaa-MM-ddTHH :mm :ssZ) de l’exemption de stratégie.

Type:	Nullable<T>[DateTime]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Id

ID de l’affectation de stratégie à supprimer. Utilisez le format « {scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName} ».

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

-InputObject

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

-Metadata

Métadonnées d’attribution de stratégie. Les métadonnées sont un objet ouvert et sont généralement une collection de paires clé-valeur.

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

-Name

Nom de l’exemption de stratégie.

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

-PolicyDefinitionReferenceId

Liste d’ID de référence de définition de stratégie lorsque l’attribution de stratégie associée concerne un jeu de stratégies (initiative).

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

-ResourceSelector

Liste de sélecteurs de ressources pour filtrer les stratégies par propriétés de ressource.

Type:	IResourceSelector[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

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

Entrées

IPolicyExemption

SwitchParameter

Nullable<T>[[System.DateTime, System.Private.CoreLib, Version=8.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

String

String[]

Sorties

IPolicyExemption

Notes

ALIAS

Set-AzPolicyExemption