Share via


Set-AzPolicyExemption

Módosítja a szabályzatok kivételét.

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

A Set-AzPolicyExemption parancsmag módosítja a szabályzatok kivételét. Adja meg a kivételt azonosító vagy név és hatókör szerint.

Példák

1. példa: A megjelenítendő név frissítése

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

Az első parancs a Get-AzResourceGroup parancsmaggal lekéri a ResourceGroup11 nevű erőforráscsoportot. A parancs az objektumot a $ResourceGroup változóban tárolja. A második parancs a Get-AzPolicyExemption parancsmaggal lekéri a PolicyExemption07 nevű házirend-kivételt. A parancs az objektumot a $PolicyExemption változóban tárolja. Az utolsó parancs frissíti a $ResourceGroup ResourceId tulajdonsága által azonosított erőforráscsoport házirend-kivételének megjelenítendő nevét.

2. példa: A lejárati idő frissítése

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

Az első parancs a Get-Date parancsmaggal lekéri az aktuális dátumot, és hozzáad 1 hónapot az aktuális dátumhoz. A parancs az objektumot a $NextMonth változóban tárolja. A második parancs a Get-AzPolicyExemption parancsmaggal lekéri a PolicyExemption07 nevű házirend-kivételt. A parancs az objektumot a $PolicyExemption változóban tárolja. Az utolsó parancs frissíti az alapértelmezett előfizetésre vonatkozó szabályzatmentesség lejárati dátumát.

3. példa: A lejárati dátum időének törlése

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

Az első parancs a Get-AzPolicyExemption parancsmaggal lekéri a PolicyExemption07 nevű házirend-kivételt. A parancs az objektumot a $PolicyExemption változóban tárolja. A második parancs törli az alapértelmezett előfizetésre vonatkozó szabályzat kivételének lejárati dátumát. A frissített kivétel soha nem jár le.

4. példa: A lejárati kategória frissítése

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

Az első parancs a Get-AzPolicyExemption parancsmaggal lekéri a PolicyExemption07 nevű házirend-kivételt. A parancs az objektumot a $PolicyExemption változóban tárolja. A második parancs frissíti az alapértelmezett előfizetés házirend-kivételének lejárati kategóriáját. A frissített kivétel soha nem jár le.

Paraméterek

-ApiVersion

Ha be van állítva, az erőforrás-szolgáltató API használni kívánt verzióját jelzi. Ha nincs megadva, az API-verzió automatikusan a legújabb elérhetőként lesz meghatározva.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClearExpiration

Ha be van állítva, ez a kapcsoló törli a frissített szabályzat kivételének lejárati dátumát és idejét.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

A frissített szabályzat kivételének leírása.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DisplayName

A frissített szabályzat kivételének megjelenítendő neve.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ExemptionCategory

A frissített szabályzatmentesség szabályzatmentességi kategóriája. A lehetséges értékek a mentesség és a enyhített értékek.

Type:String
Accepted values:Waiver, Mitigated
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ExpiresOn

A frissített szabályzat kivételének lejárati dátuma és ideje (UTC ISO 8601 formátumban yyyy-MM-ddTHH:mm:ssZ).

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Id

A frissíteni kívánt teljes szabályzatmentességi azonosító, beleértve a hatókört is, például /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

Egy másik parancsmag kimenetéből származó frissítési szabályzat kivételi objektuma.

Type:PsPolicyExemption
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Metadata

A frissített szabályzat kivételének metaadatai. Ez lehet egy JSON-metaadatokat tartalmazó fájl elérési útja, vagy a metaadatok JSON-sztringként.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

A frissíteni kívánt szabályzat kivételének neve.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PolicyDefinitionReferenceId

A szabályzatdefiníció referencia-azonosítójának listája, ha a társított szabályzat-hozzárendelés egy szabályzatkészlethez (kezdeményezéshez) tartozik.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Pre

Ha be van állítva, azt jelzi, hogy a parancsmagnak a kiadás előtti API-verziókat kell használnia, amikor automatikusan meghatározza, hogy melyik verziót használja.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

A frissített szabályzat kivételének hatóköre ( például /providers/managementGroups/{managementGroupName}) alapértelmezés szerint az aktuális előfizetésre terjed ki.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

String

String[]

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

SwitchParameter

PsPolicyExemption

Kimenetek

PsPolicyExemption