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


Get-AzPolicyDefinition

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

Синтаксис

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
   [-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
   -Id <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Описание

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

Примеры

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

Get-AzPolicyDefinition

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

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

Get-AzPolicyDefinition -Name 'VMPolicyDefinition'

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

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

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

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

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

Get-AzPolicyDefinition -SubscriptionId '3bf44b72-c631-427a-b8c8-53e2595398ca' -Builtin

Эта команда получает все встроенные определения политик из подписки с идентификатором 3bf44b72-c631-427a-b8c8-53e2595398ca.

Пример 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

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

Параметры

-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

-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

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

SwitchParameter

String

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

IPolicyDefinition