Dela via

Update-AzPolicyExemption

  • Referens
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>]
      [-ResourceSelector <IResourceSelector[]>]
      [-AssignmentScopeValidation <String>]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzPolicyExemption
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      -Id <String>
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-ResourceSelector <IResourceSelector[]>]
      [-AssignmentScopeValidation <String>]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzPolicyExemption
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-ResourceSelector <IResourceSelector[]>]
      [-AssignmentScopeValidation <String>]
      [-BackwardCompatible]
      -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 hjälp av 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 hjälp av 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: Uppdatera resursväljaren

$ResourceSelector = @{Name = "MyLocationSelector"; Selector = @(@{Kind = "resourceLocation"; NotIn = @("eastus", "eastus2")})}
Update-AzPolicyExemption -Name 'VirtualMachineExemption' -ResourceSelector $ResourceSelector

Det första kommandot skapar ett resursväljareobjekt som ska användas för att ange undantaget ska endast gälla för resurser på andra platser än USA, östra eller USA, östra 2 och lagrar det i variabeln $ResourceSelector. Det sista kommandot uppdaterar principundantaget med namnet VirtualMachineExemption med resursväljaren som anges av $ResourceSelector.

Exempel 6: [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
Godkänn pipeline-indata:False
Godkänn jokertecken: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
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ClearExpiration

Anger om du vill rensa förfallodatum och tid för principundantaget.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Confirm

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

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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
Alias:AzureRMContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DisplayName

Visningsnamnet för principtilldelningen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ExemptionCategory

Kategorin för principundantag

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken: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
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Id

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

Typ:String
Alias:ResourceId
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-InputObject

Typ:IPolicyExemption
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Namnet på principundantaget.

Typ:String
Alias:PolicyExemptionName
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourceSelector

Listan över resursväljare för att filtrera principer efter resursegenskaper.

Typ:IResourceSelector[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

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

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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