Set-AzPolicyExemption

Referens

Modul:: Az.Resources

Ändrar ett principundantag.

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

Cmdleten Set-AzPolicyExemption ändrar ett principundantag. Ange ett undantag efter ID eller efter namn och omfång.

Exempel

Exempel 1: Uppdatera visningsnamnet

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

Det första kommandot hämtar en resursgrupp med namnet ResourceGroup11 med hjälp av cmdleten Get-AzResourceGroup. Kommandot lagrar objektet i variabeln $ResourceGroup. Det andra kommandot hämtar principundantaget med namnet PolicyExemption07 med hjälp av cmdleten Get-AzPolicyExemption. Kommandot lagrar objektet i variabeln $PolicyExemption. Det sista kommandot uppdaterar visningsnamnet för principundantaget för resursgruppen som identifieras av egenskapen ResourceId för $ResourceGroup.

Exempel 2: Uppdatera förfallodatumtiden

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

Det första kommandot hämtar aktuell datumtid med cmdleten Get-Date och lägger till 1 månad till aktuell datumtid Kommandot lagrar objektet i variabeln $NextMonth. Det andra kommandot hämtar principundantaget med namnet PolicyExemption07 med hjälp av cmdleten Get-AzPolicyExemption. Kommandot lagrar objektet i variabeln $PolicyExemption. Det sista kommandot uppdaterar förfallodatumtiden för principundantaget för standardprenumerationen.

Exempel 3: Rensa förfallodatumtiden

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

Det första kommandot hämtar principundantaget med namnet PolicyExemption07 med hjälp av cmdleten Get-AzPolicyExemption. Kommandot lagrar objektet i variabeln $PolicyExemption. Det andra kommandot rensar förfallodatumtiden för principundantaget för standardprenumerationen. Det uppdaterade undantaget upphör aldrig att gälla.

Exempel 4: Uppdatera förfallokategorin

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

Det första kommandot hämtar principundantaget med namnet PolicyExemption07 med hjälp av cmdleten Get-AzPolicyExemption. Kommandot lagrar objektet i variabeln $PolicyExemption. Det andra kommandot uppdaterar förfallokategorin för principundantaget för standardprenumerationen. Det uppdaterade undantaget upphör aldrig att gälla.

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.

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearExpiration

Om den här växeln anges rensas förfallodatum och tid för det uppdaterade principundantaget.

Typ:	SwitchParameter
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

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

Typ:	SwitchParameter
Aliases:	cf
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Typ:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Beskrivningen av det uppdaterade principundantaget.

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DisplayName

Visningsnamnet för det uppdaterade principundantaget.

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ExemptionCategory

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

Typ:	String
accepterade värden:	Waiver, Mitigated
Position:	Named
standardvärde:	None
Obligatorisk:	False
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 uppdaterade principundantaget.

Typ:	Nullable<T>[DateTime]
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Id

Det fullständigt kvalificerade principundantags-ID:t som ska uppdateras, inklusive omfånget, t.ex. /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}.

Typ:	String
Aliases:	ResourceId
Position:	Named
standardvärde:	None
Obligatorisk:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InputObject

Principundantagsobjektet för att uppdatera som utdata från en annan cmdlet.

Typ:	PsPolicyExemption
Position:	Named
standardvärde:	None
Obligatorisk:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Metadata

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

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Namnet på principundantaget som ska uppdateras.

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	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).

Typ:	String[]
Position:	Named
standardvärde:	None
Obligatorisk:	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.

Typ:	SwitchParameter
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

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

Typ:	String
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Typ:	SwitchParameter
Aliases:	wi
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Indata

String

String[]

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

SwitchParameter

PsPolicyExemption

Utdata