共用方式為

Update-AzPolicyExemption

  • 參考
模組:
Az.Resources

此作業會更新具有指定範圍和名稱的原則豁免。

語法

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

此作業會更新具有指定範圍和名稱的原則豁免。

範例

範例 1：更新顯示名稱

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

第一個命令會使用 Get-AzResourceGroup Cmdlet 取得名為 ResourceGroup11 的資源群組。 命令會將該物件儲存在 $ResourceGroup 變數中。 第二個命令會使用 Get-AzPolicyExemption Cmdlet 來取得名為 PolicyExemption07 的原則豁免。 命令會將該物件儲存在$PolicyExemption變數中。 最後一個命令會更新$ResourceGroup ResourceId 屬性所識別之資源群組上的原則豁免顯示名稱。

範例 2：更新到期日時間

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

第一個命令會使用 Get-Date Cmdlet 取得目前的日期時間，並將 1 個月新增至目前的日期時間。命令會將該物件儲存在$NextMonth變數中。 第二個命令會使用 Get-AzPolicyExemption Cmdlet 來取得名為 PolicyExemption07 的原則豁免。 命令會將該物件儲存在$PolicyExemption變數中。 最後一個命令會更新預設訂用帳戶上原則豁免的到期日時間。

範例 3：清除到期日時間

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

第一個命令會使用 Get-AzPolicyExemption Cmdlet 取得名為 PolicyExemption07 的原則豁免。 命令會將該物件儲存在$PolicyExemption變數中。 第二個命令會清除預設訂用帳戶上原則豁免的到期日時間。 更新的豁免永遠不會過期。

範例 4：更新到期類別

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

第一個命令會使用 Get-AzPolicyExemption Cmdlet 取得名為 PolicyExemption07 的原則豁免。 命令會將該物件儲存在$PolicyExemption變數中。 第二個命令會更新預設訂用帳戶上原則豁免的到期類別。 更新的豁免永遠不會過期。

第一個命令會使用 Get-Date Cmdlet 取得目前的日期時間，並將 1 個月新增至目前的日期時間。命令會將該物件儲存在$NextMonth變數中。 第二個命令會使用 Get-AzPolicyExemption Cmdlet 來取得名為 PolicyExemption07 的原則豁免。 命令會將該物件儲存在$PolicyExemption變數中。 最後一個命令會更新預設訂用帳戶上原則豁免的到期日時間。

範例 5：更新資源選取器

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

第一個命令會建立資源選取器物件，該物件將用來指定豁免應該只適用於美國東部或美國東部 2 以外的位置的資源，並將它儲存在$ResourceSelector變數中。 最後一個命令會使用$ResourceSelector所指定的資源選取器，更新名為 VirtualMachineExemption 的原則豁免。

範例 6：[Backcompat] 清除到期日時間

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

第一個命令會使用 Get-AzPolicyExemption Cmdlet 取得名為 PolicyExemption07 的原則豁免。 命令會將該物件儲存在$PolicyExemption變數中。 第二個命令會清除預設訂用帳戶上原則豁免的到期日時間。 更新的豁免永遠不會過期。

參數

-AssignmentScopeValidation

驗證豁免的選項位於指派範圍或指派範圍內。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-BackwardCompatible

導致 Cmdlet 使用舊版格式將原則特定屬性放在屬性包對象中傳回成品。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ClearExpiration

指出是否要清除原則豁免的到期日期和時間。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DefaultProfile

DefaultProfile 參數無法運作。 如果針對不同的訂用帳戶執行 Cmdlet，請使用 SubscriptionId 參數。

類型:PSObject
別名:AzureRMContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Description

如果違反原則，此訊息將會是回應的一部分。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-DisplayName

原則指派的顯示名稱。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ExemptionCategory

原則豁免類別

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ExpiresOn

原則豁免的到期日期和時間 （UTC ISO 8601 格式 yyyy-MM-ddTHH：mm：ssZ）。

類型:Nullable<T>[DateTime]
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Id

要刪除的原則指派標識碼。 使用格式 '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'。

類型:String
別名:ResourceId
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-InputObject

類型:IPolicyExemption
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Metadata

原則指派元數據。 元數據是開放式物件，通常是索引鍵值組的集合。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Name

原則豁免的名稱。

類型:String
別名:PolicyExemptionName
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-PolicyDefinitionReferenceId

當相關聯的原則指派是針對原則集 （initiative） 時，原則定義參考標識符清單。

類型:String[]
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ResourceSelector

依資源屬性篩選原則的資源選取器清單。

類型:IResourceSelector[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Scope

原則豁免的範圍。 有效範圍包括：管理群組（格式：'/providers/Microsoft.Management/managementGroups/{managementGroup}'），訂用帳戶（格式：'/subscriptions/{subscriptionId}'），資源群組（格式： '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}'， 或資源 （格式： '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

IPolicyExemption

SwitchParameter

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

String

String[]

輸出

IPolicyExemption

備註

別名

Set-AzPolicyExemption