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.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
Típus: | SwitchParameter |
Aliasok: | cf |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.
Típus: | IAzureContextContainer |
Aliasok: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Description
A frissített szabályzat kivételének leírása.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-DisplayName
A frissített szabályzat kivételének megjelenítendő neve.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Elfogadott értékek: | Waiver, Mitigated |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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).
Típus: | Nullable<T>[DateTime] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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}.
Típus: | String |
Aliasok: | ResourceId |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-InputObject
Egy másik parancsmag kimenetéből származó frissítési szabályzat kivételi objektuma.
Típus: | PsPolicyExemption |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Name
A frissíteni kívánt szabályzat kivételének neve.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Típus: | SwitchParameter |
Aliasok: | wi |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
String[]
Nullable<T>[[System.DateTime, System.Private.CoreLib, Version=5.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]