Set-AzPolicyExemption
Modifie une exemption de stratégie.
Syntax
Set-AzPolicyExemption
-Name <String>
[-Scope <String>]
[-DisplayName <String>]
[-Description <String>]
[-ExemptionCategory <String>]
[-PolicyDefinitionReferenceId <String[]>]
[-ExpiresOn <DateTime>]
[-ClearExpiration]
[-Metadata <String>]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzPolicyExemption
-Id <String>
[-DisplayName <String>]
[-Description <String>]
[-ExemptionCategory <String>]
[-PolicyDefinitionReferenceId <String[]>]
[-ExpiresOn <DateTime>]
[-ClearExpiration]
[-Metadata <String>]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzPolicyExemption
[-DisplayName <String>]
[-Description <String>]
[-ExemptionCategory <String>]
[-PolicyDefinitionReferenceId <String[]>]
[-ExpiresOn <DateTime>]
[-ClearExpiration]
[-Metadata <String>]
-InputObject <PsPolicyExemption>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Set-AzPolicyExemption modifie une exemption de stratégie. Spécifiez une exemption par ID ou par nom et étendue.
Exemples
Exemple 1 : Mettre à jour le nom complet
$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId
Set-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 de $ResourceGroup.
Exemple 2 : Mettre à jour l’heure d’expiration
$NextMonth = (Get-Date).AddMonths(1)
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Set-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'
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.
Exemple 4 : Mettre à jour la catégorie d’expiration
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Set-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.
Paramètres
-ApiVersion
Quand elle est définie, indique la version de l’API du fournisseur de ressources à utiliser. Si elle n’est pas spécifiée, la version de l’API est automatiquement déterminée comme la dernière version disponible.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClearExpiration
Si cette option est définie, ce commutateur efface la date et l’heure d’expiration de l’exemption de stratégie mise à jour.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Description de l’exemption de stratégie mise à jour.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisplayName
Nom complet de l’exemption de stratégie mise à jour.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExemptionCategory
Catégorie d’exemption de stratégie de l’exemption de stratégie mise à jour. Les valeurs possibles sont Les valeurs d’exemption et d’atténuation.
Type: | String |
Accepted values: | Waiver, Mitigated |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExpiresOn
Date et heure d’expiration (au format UTC ISO 8601 aaaa-MM-ddTHH :mm :ssZ) de l’exemption de stratégie mise à jour.
Type: | Nullable<T>[DateTime] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Id
ID d’exemption de stratégie complet à mettre à jour, y compris l’étendue, par exemple /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}.
Type: | String |
Aliases: | ResourceId |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InputObject
Objet d’exemption de stratégie à mettre à jour qui a été généré à partir d’une autre applet de commande.
Type: | PsPolicyExemption |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Metadata
Métadonnées de l’exemption de stratégie mise à jour. Il peut s’agir d’un chemin d’accès à un fichier contenant les métadonnées JSON, ou des métadonnées sous forme de chaîne JSON.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Nom de l’exemption de stratégie à mettre à jour.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Pre
Quand elle est définie, indique que l’applet de commande doit utiliser des versions d’API en préversion lors de la détermination automatique de la version à utiliser.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scope
L’étendue de l’exemption de stratégie mise à jour, par exemple /providers/managementGroups/{managementGroupName}, est définie par défaut sur l’abonnement actuel.
Type: | String |
Position: | Named |
Default value: | None |
Required: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
String[]
Nullable<T>[[System.DateTime, System.Private.CoreLib, Version=5.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]