New-AzPolicyExemption
Szabályzatmentességet hoz létre vagy frissít.
Syntax
New-AzPolicyExemption
-Name <String>
-ExemptionCategory <String>
-PolicyAssignment <PSObject>
[-Scope <String>]
[-PolicyDefinitionReferenceId <String[]>]
[-AssignmentScopeValidation <String>]
[-DisplayName <String>]
[-Description <String>]
[-ExpiresOn <DateTime>]
[-Metadata <String>]
[-ResourceSelector <IResourceSelector[]>]
[-BackwardCompatible]
[-DefaultProfile <PSObject>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
A New-AzPolicyExemption parancsmag létrehoz egy szabályzatkivételt a megadott hatókörrel és névvel.
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 WaiverAz első parancs a Get-AzSubscription parancsmag használatával lekéri az Előfizetés01 nevű előfizetést, és a $Subscription változóban tárolja. A második parancs lekéri a VirtualMachinePolicyAssignment nevű szabályzat-hozzárendelést a Get-AzPolicyAssignment parancsmag használatával, é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 MitigatedAz 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 lekéri a VirtualMachinePolicyAssignment nevű szabályzat-hozzárendelést a Get-AzPolicyAssignment parancsmag használatával, é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.
3. példa: Szabályzatok kivétele felügyeleti csoport szintjén
$ManagementGroup = Get-AzManagementGroup -GroupName 'AManagementGroup'
$Assignment = Get-AzPolicyAssignment -Name 'VirtualMachinePolicyAssignment'
New-AzPolicyExemption -Name 'VirtualMachinePolicyAssignment' -PolicyAssignment $Assignment -Scope $ManagementGroup.Id -ExemptionCategory MitigatedAz első parancs lekéri az AManagementGroup nevű felügyeleti csoportot a Get-AzManagementGroup parancsmag használatával, és tárolja azt a $ManagementGroup változóban. A második parancs lekéri a VirtualMachinePolicyAssignment nevű szabályzat-hozzárendelést a Get-AzPolicyAssignment parancsmag használatával, és a $Assignment változóban tárolja. Az utolsó parancs mentesíti a szabályzat-hozzárendelést $Assignment a $ManagementGroup Azonosító tulajdonsága által azonosított felügyeleti csoport szintjén.
4. példa: Szabályzat kivétele erőforrásszinten
$VM = Get-AzVM -Name 'SpecialVM'
$Assignment = Get-AzPolicyAssignment -Name 'VirtualMachinePolicyAssignment'
New-AzPolicyExemption -Name 'VirtualMachinePolicyAssignment' -PolicyAssignment $Assignment -Scope $VM.Id -ExemptionCategory WaiverAz első parancs a Get-AzVM parancsmaggal lekéri a SpecialVM nevű virtuális gépet, és a $VM változóban tárolja. A második parancs lekéri a VirtualMachinePolicyAssignment nevű szabályzat-hozzárendelést a Get-AzPolicyAssignment parancsmag használatával, és a $Assignment változóban tárolja. Az utolsó parancs mentesíti a $VM Azonosító tulajdonsága által azonosított erőforrást a $Assignment házirend-hozzárendeléséből.
5. példa: Szabályzat kivétele erőforrás-választóval
$Assignment = Get-AzPolicyAssignment -Name 'VirtualMachineAssignment'
$ResourceSelector = @{Name = "MyLocationSelector"; Selector = @(@{Kind = "resourceLocation"; In = @("eastus", "eastus2")})}
New-AzPolicyExemption -Name 'VirtualMachinePolicyExemption' -PolicyAssignment $Assignment -ResourceSelector $ResourceSelectorAz első parancs lekéri a VirtualMachineAssignment nevű szabályzat-hozzárendelést a Get-AzPolicyAssignment parancsmag használatával, és tárolja a $Assignment változóban. A második parancs létrehoz egy erőforrás-választó objektumot, amely a kivétel megadására szolgál, és csak az USA keleti régiójában vagy az USA 2. keleti régiójában található erőforrásokra vonatkozik, és a $ResourceSelector változóban tárolja. Az utolsó parancs létrehoz egy szabályzatmentességet a hozzárendelési $Assignment a $ResourceSelector által megadott erőforrás-választóval.
Paraméterek
-AssignmentScopeValidation
A kivétel érvényesítése a hozzárendelés hatókörében vagy annak hatálya alatt van-e.
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-BackwardCompatible
A parancsmag az örökölt formátumú összetevők visszaadását okozza, amelyek szabályzatspecifikus tulajdonságokat helyeznek el egy tulajdonságcsomag-objektumban.
| Típus: | SwitchParameter |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Confirm
Megerősíté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
A DefaultProfile paraméter nem működik. Ha a parancsmagot egy másik előfizetésen hajtja végre, használja az SubscriptionId paramétert, ha elérhető.
| Típus: | PSObject |
| Aliasok: | AzureRMContext, AzureCredential |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Description
Ez az üzenet a szabályzat megsértése esetén a válasz része lesz.
| 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 szabályzat-hozzárendelés 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 szabályzatmentességi kategória
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-ExpiresOn
A 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 |
-Metadata
A szabályzat-hozzárendelés metaadatai. A metaadatok egy nyitott végű objektum, amely általában kulcsértékpárok gyűjteménye.
| 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 szabályzat kivételének neve.
| Típus: | String |
| Aliasok: | PolicyExemptionName |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | True |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-PolicyAssignment
A szabályzat-hozzárendelés azonosítójának szűrője.
| Típus: | PSObject |
| 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 |
-ResourceSelector
Az erőforrás-választó lista, amely erőforrás-tulajdonságok alapján szűri a szabályzatokat.
| Típus: | IResourceSelector[] |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | False |
| Helyettesítő karakterek elfogadása: | False |
-Scope
A szabályzatmentesség hatóköre. Érvényes hatókörök: felügyeleti csoport (formátum: "/providers/Microsoft.Management/managementGroups/{managementGroup}"), előfizetés (formátum: "/subscriptions/{subscriptionId}"), erőforráscsoport (formátum: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}", vagy erőforrás (formátum: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}"
| Típus: | String |
| Position: | Named |
| Alapértelmezett érték: | None |
| Kötelező: | False |
| Folyamatbemenet elfogadása: | True |
| Helyettesítő karakterek elfogadása: | False |
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. 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
Nullable<T>[[System.DateTime, System.Private.CoreLib, Version=8.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
String[]
