Share via


New-AzPolicyExemption

Szabályzatmentességet hoz létre.

Syntax

New-AzPolicyExemption
   -Name <String>
   [-Scope <String>]
   [-DisplayName <String>]
   [-Description <String>]
   -ExemptionCategory <String>
   -PolicyAssignment <PsPolicyAssignment>
   [-PolicyDefinitionReferenceId <String[]>]
   [-ExpiresOn <DateTime>]
   [-Metadata <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

A New-AzPolicyExemption parancsmag szabályzatmentességet hoz létre. Adjon meg egy szabályzat-hozzárendelést, kivételkategóriát és hatókört.

Példák

1. példa: Szabályzatok kivétele előfizetési szinten

$Subscription = Get-AzSubscription -SubscriptionName 'Subscription01'
$Assignment = Get-AzPolicyAssignment -Name 'VirtualMachinePolicyAssignment'
New-AzPolicyExemption -Name 'VirtualMachinePolicyExemption' -PolicyAssignment $Assignment -Scope "/subscriptions/$($Subscription.Id)" -ExemptionCategory Waiver

Az első parancs lekéri az Előfizetés01 nevű előfizetést a Get-AzSubscription parancsmag használatával, és a $Subscription változóban tárolja. A második parancs a Get-AzPolicyAssignment parancsmaggal lekéri a VirtualMachinePolicyAssignment nevű szabályzat-hozzárendelést, és a $Assignment változóban tárolja. Az utolsó parancs mentesíti a szabályzat-hozzárendelést $Assignment az előfizetés hatókörének sztringje által azonosított előfizetés szintjén.

2. példa: Szabályzat kivétele erőforráscsoport szintjén

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
$Assignment = Get-AzPolicyAssignment -Name 'VirtualMachinePolicyAssignment'
New-AzPolicyExemption -Name 'VirtualMachinePolicyAssignment' -PolicyAssignment $Assignment -Scope $ResourceGroup.ResourceId -ExemptionCategory Mitigated

Az első parancs a Get-AzResourceGroup parancsmaggal lekéri a ResourceGroup11 nevű erőforráscsoportot, és a $ResourceGroup változóban tárolja. A második parancs a Get-AzPolicyAssignment parancsmaggal lekéri a VirtualMachinePolicyAssignment nevű szabályzat-hozzárendelést, és a $Assignment változóban tárolja. Az utolsó parancs mentesíti a szabályzat-hozzárendelést $Assignment a $ResourceGroup ResourceId tulajdonsága által azonosított erőforráscsoport szintjén.

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

-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

Az új 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

Az új 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

Az új 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:True
Accept pipeline input:True
Accept wildcard characters:False

-ExpiresOn

Az új szabályzatmentesség 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

-Metadata

Az új 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

Az új szabályzat kivételének neve.

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

-PolicyAssignment

Az új házirend-kivétel hivatkozott szabályzat-hozzárendelési azonosítója.

Type:PsPolicyAssignment
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

Az új 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

PsPolicyAssignment

String[]

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

Kimenetek

PsPolicyExemption