Start-AzPolicyRemediation

Модуль:: Az.PolicyInsights Module

Создает и запускает исправление политики для назначения политики.

Синтаксис

ByName (По умолчанию)

Start-AzPolicyRemediation
    -Name <String>
    -PolicyAssignmentId <String>
    [-Scope <String>]
    [-ManagementGroupName <String>]
    [-ResourceGroupName <String>]
    [-PolicyDefinitionReferenceId <String>]
    [-LocationFilter <String[]>]
    [-ResourceDiscoveryMode <String>]
    [-ResourceCount <Int32>]
    [-ParallelDeploymentCount <Int32>]
    [-FailureThreshold <Double>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByResourceId

Start-AzPolicyRemediation
    -ResourceId <String>
    -PolicyAssignmentId <String>
    [-PolicyDefinitionReferenceId <String>]
    [-LocationFilter <String[]>]
    [-ResourceDiscoveryMode <String>]
    [-ResourceCount <Int32>]
    [-ParallelDeploymentCount <Int32>]
    [-FailureThreshold <Double>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Командлет Start-AzPolicyRemediation создает исправление политики для определенного назначения политики. Все несоответствующие ресурсы по области исправления будут исправлены или ниже. Исправление поддерживается только для политик с эффектом deployIfNotExists и modify.

Примеры

Пример 1. Запуск исправления в области подписки

$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Set-AzContext -Subscription "My Subscription"
Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1"

Эта команда создает новую исправление политики в подписке "Моя подписка" для заданного назначения политики.

Пример 2. Запуск исправления в области группы управления с дополнительными фильтрами

$policyAssignmentId = "/providers/Microsoft.Management/managementGroups/mg1/providers/Microsoft.Authorization/policyAssignments/pa1"
Start-AzPolicyRemediation -ManagementGroupName "mg1" -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -LocationFilter "westus","eastus"

Эта команда создает новую исправление политики в группе управления "mg1" для заданного назначения политики. Будут устранены только ресурсы в расположениях "westus" или "eastus".

Пример 3. Запуск исправления в области группы ресурсов для назначения определения набора политик

$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/resourceGroups/myRG/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Start-AzPolicyRemediation -ResourceGroupName "myRG" -PolicyAssignmentId $policyAssignmentId -PolicyDefinitionReferenceId "0349234412441" -Name "remediation1"

Эта команда создает новую исправление политики в группе ресурсов myRG для заданного назначения политики. Назначение политики назначает определение набора политик (также известное как инициатива). Идентификатор ссылки на определение политики указывает, какая политика в рамках инициативы должна быть исправлена.

Пример 4. Запуск исправления и ожидание его завершения в фоновом режиме

$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Set-AzContext -Subscription f0710c27-9663-4c05-19f8-1b4be01e86a5
$job = Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -AsJob
$job | Wait-Job
$remediation = $job | Receive-Job

Эта команда запускает новую исправление политики в подписке "Моя подписка" для заданного назначения политики. Он ожидает завершения исправления перед возвратом окончательного состояния исправления.

Пример 5. Запустите исправление, которое обнаружит несоответствующие ресурсы перед исправлением

$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Set-AzContext -Subscription "My Subscription"
Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -ResourceDiscoveryMode ReEvaluateCompliance

Эта команда создает новую исправление политики в подписке "Моя подписка" для заданного назначения политики. Состояние соответствия ресурсов в подписке будет повторно оценено по назначению политики и несоответствующим ресурсам будет исправлено.

Пример 6. Запуск исправления, которое приведет к исправлению до 10 000 несоответствующих ресурсов.

$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Set-AzContext -Subscription "My Subscription"
Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -ResourceCount 10000

Пример 7. Запуск исправления, который будет исправлять 30 ресурсов параллельно

$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Set-AzContext -Subscription "My Subscription"
Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -ParallelDeploymentCount 30

Пример 8. Запуск исправления, которое завершится, если более половины развертываний исправления завершаются сбоем.

$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Set-AzContext -Subscription "My Subscription"
Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -FailureThreshold 0.5

Параметры

-AsJob

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

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

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

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

(All)

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

-Confirm

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

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

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

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

(All)

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

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure.

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

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

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

(All)

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

-FailureThreshold

Число от 0,0 до 1,0, представляющее пороговое значение процента сбоя. Исправление завершится ошибкой, если процент неудачных операций исправления (т. е. неудачных развертываний) превышает это пороговое значение.

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

Тип:	Nullable<T>[Double]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

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

(All)

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

-LocationFilter

Расположения ресурсов, которые должны быть включены в исправление. Ресурсы, которые не находятся в этих расположениях, не будут устранены.

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

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

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

(All)

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

-ManagementGroupName

Идентификатор группы управления.

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

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

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

ByName

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

-Name

Имя ресурса.

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

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

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

ByName

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

-ParallelDeploymentCount

Сколько ресурсов необходимо исправить в любое время. Можно использовать для управления темпом исправления. Если это не указано, используется значение параллельных развертываний по умолчанию.

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

Тип:	Nullable<T>[Int32]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

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

(All)

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

-PolicyAssignmentId

Идентификатор назначения политики. Например, '/subscriptions/{subscriptionId}/providers/Майкрософт. Authorization/policyAssignments/{assignmentName}'.

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

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

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

(All)

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

-PolicyDefinitionReferenceId

Возвращает идентификатор ссылки на определение политики для отдельного определения, которое выполняется исправление. Требуется, когда назначение политики назначает определение набора политик.

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

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

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

(All)

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

-ResourceCount

Максимальное количество несоответствующих ресурсов, которые будут исправлены. Если это не указано, используется число ресурсов по умолчанию.

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

Тип:	Nullable<T>[Int32]
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

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

(All)

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

-ResourceDiscoveryMode

Описывает, как задача исправления обнаружит ресурсы, которые необходимо исправить. ReEvaluateCompliance не поддерживается при исправлении областей группы управления.

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

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

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

(All)

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

-ResourceGroupName

Имя группы ресурсов.

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

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

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

ByName

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

-ResourceId

Идентификатор ресурса.

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

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

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

ByResourceId

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

-Scope

Область ресурса. Например, '/subscriptions/{subscriptionId}/resourceGroups/{rgName}'.

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

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

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

ByName

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.

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

String

Nullable<T>

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

PSRemediation

Обратная связь

Были ли сведения на этой странице полезными?