Get-AzPolicyDefinition
Возвращает определения политики.
Синтаксис
Get-AzPolicyDefinition
[-Name <String>]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyDefinition
[-Name <String>]
-ManagementGroupName <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyDefinition
[-Name <String>]
-SubscriptionId <Guid>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyDefinition
-Id <String>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyDefinition
[-ManagementGroupName <String>]
[-SubscriptionId <Guid>]
[-Builtin]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzPolicyDefinition
[-ManagementGroupName <String>]
[-SubscriptionId <Guid>]
[-Custom]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<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 '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 -ExpandProperty properties | Select-Object -Property DisplayName, Description, PolicyType, Metadata | Format-List
Эта команда полезна, если необходимо найти свойство DisplayName, понятное для чтения, определения Политика Azure. Вы можете проанализировать свойство метаданных , чтобы обнаружить номер версии определения политики и назначение категории.
Параметры
-ApiVersion
Указывает версию API поставщика ресурсов для использования. Если вы не указываете версию, этот командлет использует последнюю доступную версию.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Builtin
Ограничивает список результатов только встроенными определениями политик.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Custom
Ограничивает список результатов только пользовательскими определениями политик.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DefaultProfile
Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure
Тип: | IAzureContextContainer |
Aliases: | AzContext, 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 |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-Pre
Указывает, что этот командлет рассматривает версии API предварительной версии, когда она автоматически определяет, какую версию следует использовать.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SubscriptionId
Идентификатор подписки для получения определений политик.
Тип: | Nullable<T>[Guid] |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
Входные данные
Nullable<T>[[System.Guid, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]