Get-AzPolicyDefinition

Ссылка

Модуль:: Az.Resources

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

Синтаксис

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

Get-AzPolicyDefinition
   [-Name <String>]
   -ManagementGroupName <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-Name <String>]
   -SubscriptionId <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-Name <String>]
   [-Id <String>]
   [-BackwardCompatible]
   -Version <String>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-Name <String>]
   [-Id <String>]
   [-ListVersion]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

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

Get-AzPolicyDefinition
   [-SubscriptionId <String>]
   [-ManagementGroupName <String>]
   [-Builtin]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-SubscriptionId <String>]
   [-ManagementGroupName <String>]
   [-Custom]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-SubscriptionId <String>]
   [-ManagementGroupName <String>]
   [-Static]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Описание

Командлет Get-AzPolicyDefinition получает коллекцию определений наборов политик или определенное определение набора политик, определяемое именем или идентификатором.

Примеры

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

Get-AzPolicyDefinition

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

Пример 2. Получение определения политики из текущей подписки по имени

Get-AzPolicyDefinition -Name 'VMPolicyDefinition'

Эта команда получает определение политики с именем VMPolicyDefinition из текущей подписки по умолчанию.

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

Get-AzPolicyDefinition -Name 'VMPolicyDefinition' -ManagementGroupName 'Dept42'

Эта команда получает определение политики с именем VMPolicyDefinition из группы управления с именем Dept42.

Пример 4. Получение всех встроенных определений политик из подписки

Get-AzPolicyDefinition -SubscriptionId 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e' -Builtin

Эта команда получает все встроенные определения политики из подписки с идентификатором aaaa0a0a-bb1b-cc2c-dd3d-ee4e4e4e4e4e4e4e.

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

Get-AzPolicyDefinition | Where-Object {$_.Properties.metadata.category -eq 'Tags'}

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

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

Get-AzPolicyDefinition | Select-Object -Property DisplayName, Description, PolicyType, Metadata | Format-List

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

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

Get-AzPolicyDefinition -BackwardCompatible | Select-Object -ExpandProperty properties | Select-Object -Property DisplayName, Description, PolicyType, Metadata | Format-List

Параметры

-BackwardCompatible

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

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

-Builtin

Вызывает возврат только встроенных определений политик командлета.

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

-Custom

Вызывает возврат только пользовательских определений политик командлета.

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

-DefaultProfile

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

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

-Id

Полный идентификатор определения политики для получения.

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

-ListVersion

Вызывает возврат только пользовательских определений политик командлета.

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

-ManagementGroupName

Имя группы управления.

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

-Name

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

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

-Static

Вызывает возврат только статических определений политик командлета.

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

-SubscriptionId

Идентификатор целевой подписки.

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

-Version

Версия определения политики в формате #.#.#

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

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

SwitchParameter

String

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

IPolicyDefinition

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