Update-AzPolicyExemption

Modul:

Az.Resources

Den här åtgärden uppdaterar ett principundantag med angivet omfång och namn.

Syntax

Update-AzPolicyExemption
      -Name <String>
      [-Scope <String>]
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-BackwardCompatible]
      [-AssignmentScopeValidation <String>]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzPolicyExemption
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      -Id <String>
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-BackwardCompatible]
      [-AssignmentScopeValidation <String>]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzPolicyExemption
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-BackwardCompatible]
      [-AssignmentScopeValidation <String>]
      -InputObject <IPolicyExemption>
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Den här åtgärden uppdaterar ett principundantag med angivet omfång och namn.

Exempel

Exempel 1: Uppdatera visningsnamnet

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
 $PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId
Update-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'
Update-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'
Update-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'
Update-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.

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 5: [Backcompat] 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.

Parametrar

-AssignmentScopeValidation

Alternativet om du vill verifiera undantaget finns i eller under tilldelningsomfånget.

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

-BackwardCompatible

Gör att cmdleten returnerar artefakter med äldre format som placerar principspecifika egenskaper i ett egenskapspåseobjekt.

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

-ClearExpiration

Anger om du vill rensa förfallodatum och tid för 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

Parametern DefaultProfile fungerar inte. Använd parametern SubscriptionId när den är tillgänglig om du kör cmdleten mot en annan prenumeration.

Typ:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
standardvärde:	None
Obligatorisk:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Det här meddelandet är en del av svaret i händelse av principöverträdelse.

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

-DisplayName

Visningsnamnet för principtilldelningen.

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

-ExemptionCategory

Kategorin för principundantag

Typ:	String
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 principundantaget.

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

-Id

ID:t för principtilldelningen som ska tas bort. Använd formatet {scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}.

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

-InputObject

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

-Metadata

Metadata för principtilldelning. Metadata är ett öppet slutobjekt och är vanligtvis en samling nyckelvärdepar.

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

-Name

Namnet på principundantaget.

Typ:	String
Aliases:	PolicyExemptionName
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

-Scope

Omfånget för principundantaget. Giltiga omfång är: hanteringsgrupp (format: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), prenumeration (format: '/subscriptions/{subscriptionId}'), resursgrupp (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', eller resurs (format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

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

IPolicyExemption

SwitchParameter

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

String

String[]

Utdata

IPolicyExemption

Kommentarer

ALIAS

Set-AzPolicyExemption