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


Update-AzPolicyExemption

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

Синтаксис

Name (по умолчанию)

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

Id

Update-AzPolicyExemption
    -Id <String>
    [-ExemptionCategory <String>]
    [-PolicyDefinitionReferenceId <String[]>]
    [-DisplayName <String>]
    [-Description <String>]
    [-ExpiresOn <DateTime>]
    [-ClearExpiration]
    [-Metadata <String>]
    [-ResourceSelector <IResourceSelector[]>]
    [-AssignmentScopeValidation <String>]
    [-BackwardCompatible]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObject

Update-AzPolicyExemption
    -InputObject <IPolicyExemption>
    [-ExemptionCategory <String>]
    [-PolicyDefinitionReferenceId <String[]>]
    [-DisplayName <String>]
    [-Description <String>]
    [-ExpiresOn <DateTime>]
    [-ClearExpiration]
    [-Metadata <String>]
    [-ResourceSelector <IResourceSelector[]>]
    [-AssignmentScopeValidation <String>]
    [-BackwardCompatible]
    [-DefaultProfile <PSObject>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

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

Примеры

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

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

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

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

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

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

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

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

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

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

Пример 5. Обновление селектора ресурсов

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

Первая команда создает объект селектора ресурсов, который будет использоваться для указания исключения, должен применяться только к ресурсам в расположениях, отличных от восточной части США или восточной части США 2, и сохраняет его в переменной $ResourceSelector. Последняя команда обновляет исключение политики с именем VirtualMachineExemption с помощью селектора ресурсов, указанного в $ResourceSelector.

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

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

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

Параметры

-AssignmentScopeValidation

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-BackwardCompatible

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ClearExpiration

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DefaultProfile

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

Свойства параметра

Тип:PSObject
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:AzureRMContext, AzureCredential

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Description

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-DisplayName

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ExemptionCategory

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ExpiresOn

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

Свойства параметра

Тип:

Nullable<T>[DateTime]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Id

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:ResourceId (Идентификатор ресурса)

Наборы параметров

Id
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-InputObject

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

Свойства параметра

Тип:IPolicyExemption
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

InputObject
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Metadata

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Name

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:PolicyExemptionName

Наборы параметров

Name
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-PolicyDefinitionReferenceId

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

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-ResourceSelector

Список селекторов ресурсов для фильтрации политик по свойствам ресурсов.

Свойства параметра

Тип:

IResourceSelector[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера: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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Name
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-WhatIf

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

IPolicyExemption

SwitchParameter

Nullable<T>

String

String

Выходные данные

IPolicyExemption

Примечания

ПСЕВДОНИМЫ

Set-AzPolicyExemption