Поделиться через

Update-AzPolicyExemption

  • Ссылка
Модуль:
Az.Resources

Эта операция обновляет исключение политики с заданным область и именем.

Синтаксис

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

Описание

Эта операция обновляет исключение политики с заданным область и именем.

Примеры

Пример 1. Обновление отображаемого имени

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

Первая команда получает группу ресурсов с именем ResourceGroup11 с помощью командлета Get-AzResourceGroup. Команда сохраняет этот объект в переменной $ResourceGroup. Вторая команда получает исключение политики с именем PolicyExemption07 с помощью командлета Get-AzPolicyExemption. Команда сохраняет этот объект в переменной $PolicyExemption. Последняя команда обновляет отображаемое имя для исключения политики в группе ресурсов, определяемой свойством ResourceId $ResourceGroup.

Пример 2. Обновление даты окончания срока действия

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

Первая команда получает текущее время даты с помощью командлета Get-Date и добавьте 1 месяц к текущему времени даты, когда команда сохраняет этот объект в переменной $NextMonth. Вторая команда получает исключение политики с именем PolicyExemption07 с помощью командлета Get-AzPolicyExemption. Команда сохраняет этот объект в переменной $PolicyExemption. Последняя команда обновляет время окончания срока действия для исключения политики в подписке по умолчанию.

Пример 3. Очистка даты окончания срока действия

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

Первая команда получает исключение политики с именем PolicyExemption07 с помощью командлета Get-AzPolicyExemption. Команда сохраняет этот объект в переменной $PolicyExemption. Вторая команда очищает время окончания срока действия для исключения политики в подписке по умолчанию. Обновленное исключение никогда не истекает.

Пример 4. Обновление категории окончания срока действия

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

Первая команда получает исключение политики с именем PolicyExemption07 с помощью командлета Get-AzPolicyExemption. Команда сохраняет этот объект в переменной $PolicyExemption. Вторая команда обновляет категорию срока действия для исключения политики в подписке по умолчанию. Обновленное исключение никогда не истекает.

Первая команда получает текущее время даты с помощью командлета Get-Date и добавьте 1 месяц к текущему времени даты, когда команда сохраняет этот объект в переменной $NextMonth. Вторая команда получает исключение политики с именем PolicyExemption07 с помощью командлета Get-AzPolicyExemption. Команда сохраняет этот объект в переменной $PolicyExemption. Последняя команда обновляет время окончания срока действия для исключения политики в подписке по умолчанию.

Пример 5. [Backcompat] Очистить время окончания срока действия

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

Первая команда получает исключение политики с именем PolicyExemption07 с помощью командлета Get-AzPolicyExemption. Команда сохраняет этот объект в переменной $PolicyExemption. Вторая команда очищает время окончания срока действия для исключения политики в подписке по умолчанию. Обновленное исключение никогда не истекает.

Параметры

-AssignmentScopeValidation

Параметр проверки исключения находится в область назначения или под ней.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-BackwardCompatible

Позволяет командлету возвращать артефакты с помощью устаревшего формата размещения свойств, относящихся к политике, в объекте контейнера свойств.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ClearExpiration

Указывает, следует ли очистить дату и время истечения срока действия исключения политики.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DefaultProfile

Параметр DefaultProfile не работает. Используйте параметр SubscriptionId, если он доступен при выполнении командлета в другой подписке.

Тип:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Description

Это сообщение будет частью ответа в случае нарушения политики.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-DisplayName

Отображаемое имя назначения политики.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ExemptionCategory

Категория исключения политики

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ExpiresOn

Дата и время окончания срока действия (в формате UTC ISO 8601 формат гггг-ММ-ддTHH:mm:ssZ) исключения политики.

Тип:Nullable<T>[DateTime]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Id

Идентификатор назначения политики для удаления. Используйте формат "{область}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}".

Тип:String
Aliases:ResourceId
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-InputObject

Тип:IPolicyExemption
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Metadata

Метаданные назначения политики. Метаданные — это открытый завершенный объект, который обычно представляет собой коллекцию пар значений ключей.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

Имя исключения политики.

Тип:String
Aliases:PolicyExemptionName
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-PolicyDefinitionReferenceId

Список ссылочных идентификаторов определения политики при назначении связанной политики для набора политик (инициативы).

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Scope

Область исключения политики. Допустимые область: группа управления (формат : "/providers/Microsoft.Management/managementGroups/{managementGroup}"), подписка (формат "/subscriptions/{subscriptionId}"), группа ресурсов (формат "/subscriptionId}/{subscriptionId}/resourceGroups/{resourceGroupName}", или ресурс (формат: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{ resourceName}'

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value: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