Get-AzPolicyAssignment

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

Возвращает назначения политик.

Синтаксис

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

Get-AzPolicyAssignment
    [-BackwardCompatible]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Name

Get-AzPolicyAssignment
    -Name <String>
    [-Scope <String>]
    [-BackwardCompatible]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

PolicyDefinitionId

Get-AzPolicyAssignment
    -PolicyDefinitionId <String>
    [-Scope <String>]
    [-BackwardCompatible]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

IncludeDescendent

Get-AzPolicyAssignment
    [-Scope <String>]
    [-IncludeDescendent]
    [-BackwardCompatible]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Scope

Get-AzPolicyAssignment
    -Scope <String>
    [-BackwardCompatible]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Id

Get-AzPolicyAssignment
    -Id <String>
    [-BackwardCompatible]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Описание

Командлет Get-AzPolicyAssignment получает все назначения политик или определенные назначения. Определите назначение политики для получения по имени и области или по идентификатору.

Примеры

Пример 1. Получение всех назначений политик

Get-AzPolicyAssignment

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

Пример 2. Получение определенного назначения политики

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId

Первая команда получает группу ресурсов с именем ResourceGroup11 с помощью командлета Get-AzResourceGroup и сохраняет ее в переменной $ResourceGroup. Вторая команда получает назначение политики с именем PolicyAssignment07 для области, которую определяет свойство ResourceId $ResourceGroup.

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

$mgId = 'myManagementGroup'
Get-AzPolicyAssignment -Scope "/providers/Microsoft.Management/managementgroups/$mgId"

Первая команда задает идентификатор группы управления для запроса. Вторая команда получает все назначения политик, назначенные группе управления с идентификатором myManagementGroup.

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

Get-AzPolicyAssignment | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List

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

Пример 5. [Backcompat] Получение области, идентификатор определения набора политик и отображаемое имя всех назначений политик, отформатированных в виде списка

Get-AzPolicyAssignment -BackwardCompatible | Select-Object -ExpandProperty properties | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List

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

Параметры

-BackwardCompatible

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

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

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

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

(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

-Id

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

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

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

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

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

-IncludeDescendent

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

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

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

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

IncludeDescendent

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

-Name

Имя назначения политики для получения.

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

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

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

Name

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

-PolicyDefinitionId

Получите все назначения политик, предназначенные для заданного определения политики [полный] идентификатор.

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

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

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

PolicyDefinitionId

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

-Scope

Область назначения политики. Допустимые области: группа управления (формат "/providers/Майкрософт". 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

PolicyDefinitionId

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

IncludeDescendent

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

CommonParameters

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

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

SwitchParameter

String

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

IPolicyAssignment

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

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