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

Set-AzPolicyExemption

修改策略豁免。

语法

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

说明

Set-AzPolicyExemption cmdlet 修改策略豁免。 按 ID 或名称和范围指定豁免。

示例

示例 1:更新显示名称

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

第一个命令使用 Get-Date cmdlet 获取当前日期时间,并将 1 个月添加到当前日期时间。该命令将该对象存储在$NextMonth变量中。 第二个命令使用 Get-AzPolicyExemption cmdlet 获取名为 PolicyExemption07 的策略豁免。 该命令将该对象存储在$PolicyExemption变量中。 最终命令更新默认订阅上策略豁免的到期日期时间。

示例 3:清除到期日期时间

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

第一个命令使用 Get-AzPolicyExemption cmdlet 获取名为 PolicyExemption07 的策略豁免。 该命令将该对象存储在$PolicyExemption变量中。 第二个命令清除默认订阅上策略豁免的到期日期时间。 更新的豁免永远不会过期。

示例 4:更新过期类别

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

第一个命令使用 Get-AzPolicyExemption cmdlet 获取名为 PolicyExemption07 的策略豁免。 该命令将该对象存储在$PolicyExemption变量中。 第二个命令更新默认订阅上策略豁免的过期类别。 更新的豁免永远不会过期。

参数

-ApiVersion

设置时,指示要使用的资源提供程序 API 的版本。 如果未指定,API 版本将自动确定为最新的可用版本。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ClearExpiration

如果设置,此开关将清除更新的策略豁免的到期日期和时间。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Description

更新的策略豁免的说明。

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-DisplayName

更新的策略豁免的显示名称。

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ExemptionCategory

更新的策略豁免的策略豁免类别。 可能的值为“豁免”和“缓解”。

Type:String
Accepted values:Waiver, Mitigated
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ExpiresOn

过期日期和时间 (UTC ISO 8601 格式 yyyy-MM-ddTHH:mm:ssZ) 更新的策略豁免。

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Id

要更新的完全限定策略豁免 ID,包括范围,例如 /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}。

Type:String
Aliases:ResourceId
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

要更新另一个 cmdlet 输出的策略豁免对象。

Type:PsPolicyExemption
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Metadata

更新的策略豁免的元数据。 这可以是包含元数据 JSON 的文件的路径,也可以是作为 JSON 字符串的元数据。

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

要更新的策略豁免的名称。

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-PolicyDefinitionReferenceId

当关联的策略分配用于策略集 (计划) 时,策略定义引用 ID 列表。

Type:String[]
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Pre

设置时,指示 cmdlet 应在自动确定要使用的版本时使用预发布 API 版本。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Scope

更新的策略豁免范围,例如 /providers/managementGroups/{managementGroupName},默认为当前订阅。

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

输入

String

String[]

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

SwitchParameter

PsPolicyExemption

输出

PsPolicyExemption