New-AzPolicyExemption

Referens

Modul:: Az.Resources

Skapar ett principundantag.

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

Cmdleten New-AzPolicyExemption skapar ett principundantag. Ange en principtilldelning, undantagskategori och omfång.

Exempel

Exempel 1: Principundantag på prenumerationsnivå

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

Det första kommandot hämtar en prenumeration med namnet Subscription01 med hjälp av cmdleten Get-AzSubscription och lagrar den i variabeln $Subscription. Det andra kommandot hämtar principtilldelningen med namnet VirtualMachinePolicyAssignment med hjälp av cmdleten Get-AzPolicyAssignment och lagrar den i variabeln $Assignment. Det sista kommandot undantar principtilldelningen i $Assignment på den prenumerationsnivå som identifieras av prenumerationsomfångssträngen.

Exempel 2: Principundantag på resursgruppsnivå

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

Det första kommandot hämtar en resursgrupp med namnet ResourceGroup11 med hjälp av cmdleten Get-AzResourceGroup och lagrar den i variabeln $ResourceGroup. Det andra kommandot hämtar principtilldelningen med namnet VirtualMachinePolicyAssignment med hjälp av cmdleten Get-AzPolicyAssignment och lagrar den i variabeln $Assignment. Det sista kommandot undantar principtilldelningen i $Assignment på den resursgrupp som identifieras av egenskapen ResourceId för $ResourceGroup.

Parametrar

-ApiVersion

När värdet anges anger du vilken version av resursprovider-API:et som ska användas. Om den inte anges bestäms API-versionen automatiskt som den senaste tillgängliga.

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

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

-Description

Beskrivningen av det nya principundantaget.

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

-DisplayName

Visningsnamnet för det nya principundantaget.

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

-ExemptionCategory

Kategorin för principundantag för det nya principundantaget. Möjliga värden är Undantag och Minimerade.

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

-ExpiresOn

Förfallodatum och tid (i UTC ISO 8601-format åååå-MM-ddTHH:mm:ssZ) för det nya principundantaget.

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

-Metadata

Metadata för det nya principundantaget. Detta kan antingen vara en sökväg till en fil som innehåller metadata-JSON eller metadata som en JSON-sträng.

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

-Name

Namnet på det nya principundantaget.

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

-PolicyAssignment

Det refererade principtilldelnings-ID:t för det nya principundantaget.

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

-PolicyDefinitionReferenceId

Referens-ID:t för principdefinitionen när den associerade principtilldelningen är för en principuppsättning (initiativ).

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

-Pre

När den anges anger att cmdleten ska använda förhandsversioner av API-versioner när du automatiskt avgör vilken version som ska användas.

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

-Scope

Omfånget för det nya principundantaget, t.ex. /providers/managementGroups/{managementGroupName}, är standard för den aktuella prenumerationen.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

Indata

String

PsPolicyAssignment

String[]

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

Utdata

PsPolicyExemption