通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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>]

说明

此操作使用给定的范围和名称更新策略豁免。

示例

示例 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

要删除的策略分配的 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

当关联的策略分配用于策略集（计划）时，策略定义引用 ID 列表。

类型: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