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

Get-AzPolicyStateSummary

  • Ссылка
Модуль:
Az.PolicyInsights

Возвращает последнюю сводку состояний соответствия политик для ресурсов.

Синтаксис

Get-AzPolicyStateSummary
   [-SubscriptionId <String>]
   [-Top <Int32>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyStateSummary
   -ManagementGroupName <String>
   [-Top <Int32>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyStateSummary
   [-SubscriptionId <String>]
   -ResourceGroupName <String>
   [-Top <Int32>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyStateSummary
   [-SubscriptionId <String>]
   -PolicySetDefinitionName <String>
   [-Top <Int32>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyStateSummary
   [-SubscriptionId <String>]
   -PolicyDefinitionName <String>
   [-Top <Int32>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyStateSummary
   [-SubscriptionId <String>]
   -PolicyAssignmentName <String>
   [-Top <Int32>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyStateSummary
   [-SubscriptionId <String>]
   -ResourceGroupName <String>
   -PolicyAssignmentName <String>
   [-Top <Int32>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyStateSummary
   -ResourceId <String>
   [-Top <Int32>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Описание

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

Примеры

Пример 1. Получение последних состояний политики, не соответствующих требованиям, в текущей области подписки

Get-AzPolicyStateSummary

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

Пример 2. Получение последней несоответствующей информации о состояниях политики в указанной области подписки

Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5"

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

Пример 3. Получение последней несоответствующей информации о состояниях политики в области группы управления

Get-AzPolicyStateSummary -ManagementGroupName "myManagementGroup"

Возвращает сводное представление последних состояний соответствия политик, созданных за последний день для всех ресурсов в указанной группе управления.

Пример 4. Получение последней несоответствующей информации о состояниях политики в области группы ресурсов в текущей подписке

Get-AzPolicyStateSummary -ResourceGroupName "myResourceGroup"

Возвращает сводное представление последних состояний соответствия политик, созданных за последний день для всех ресурсов в указанной группе ресурсов (в подписке в текущем контексте сеанса).

Пример 5. Получение последней несоответствующей политики сводка состояний в области группы ресурсов в указанной подписке

Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -ResourceGroupName "myResourceGroup"

Возвращает сводное представление последних состояний соответствия политик, созданных за последний день для всех ресурсов в указанной группе ресурсов (в указанной подписке).

Пример 6. Получение последней несоответствующей информации о состояниях политики для ресурса

Get-AzPolicyStateSummary -ResourceId "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myResourceGroup/providers/Microsoft.EventHub/namespaces/myns1/eventhubs/eh1/consumergroups/cg1"

Возвращает сводное представление последних состояний соответствия политик, созданных в последний день для указанного ресурса.

Пример 7. Получение последней несоответствующей сводки состояний политики для определения набора политик в текущей подписке

Get-AzPolicyStateSummary -PolicySetDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"

Возвращает сводное представление последних состояний соответствия политик, созданных в последний день для всех ресурсов (в контексте текущего сеанса) с учетом указанного определения набора политик (существующего в подписке в текущем контексте сеанса).

Пример 8. Получение последней несоответствующей сводки состояний политики для определения набора политик в указанной подписке

Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -PolicySetDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"

Возвращает сводное представление последних состояний соответствия политик, созданных в последний день для всех ресурсов (в контексте текущего сеанса) с учетом указанного определения набора политик (которое существует в указанной подписке).

Пример 9. Получение последней несоответствующей сводки состояний политики для определения политики в текущей подписке

Get-AzPolicyStateSummary -PolicyDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"

Возвращает сводное представление последних состояний соответствия политик, созданных в последний день для всех ресурсов (в контексте текущего сеанса), которые влияют на указанное определение политики (которое существует в подписке в текущем контексте сеанса).

Пример 10. Получение последней несоответствующей информации о состояниях политики для определения политики в указанной подписке

Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -PolicyDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"

Возвращает сводное представление последних состояний соответствия политик, созданных за последний день для всех ресурсов (в контексте текущего сеанса) в соответствии с указанным определением политики (которое существует в указанной подписке).

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

Get-AzPolicyStateSummary -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"

Возвращает сводное представление последних состояний соответствия политик, созданных в последний день для всех ресурсов (в контексте текущего сеанса клиента) с учетом указанного назначения политики (существующего в подписке в текущем контексте сеанса).

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

Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"

Возвращает сводное представление последних состояний соответствия политик, созданных в последний день для всех ресурсов (в контексте текущего сеанса в клиенте), влияющих на указанное назначение политики (которое существует в указанной подписке).

Пример 13. Получение последней несоответствующей информации о состояниях политики для назначения политики в указанной группе ресурсов в текущей подписке

Get-AzPolicyStateSummary -ResourceGroupName "myResourceGroup" -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"

Возвращает сводное представление последних состояний соответствия политик, созданных за последний день для всех ресурсов (в текущем контексте сеанса клиента), которые влияют на указанное назначение политики (которое существует в группе ресурсов в подписке в текущем контексте сеанса).

Пример 14. Получение последней несоответствующей информации о состояниях политики в текущей области подписки с параметром "Верхний запрос"

Get-AzPolicyStateSummary -Top 5

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

Пример 15. Получение последней несоответствующей информации о состояниях политики в текущей области подписки с параметрами запроса from и To

Get-AzPolicyStateSummary -From "2018-03-08 00:00:00Z" -To "2018-03-15 00:00:00Z"

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

Пример 16. Получение последней несоответствующей информации о состояниях политики в текущей области подписки с параметром "Фильтр запроса"

Get-AzPolicyStateSummary -Filter "(PolicyDefinitionAction eq 'deny' or PolicyDefinitionAction eq 'audit') and ResourceLocation ne 'eastus'"

Возвращает сводное представление последних состояний соответствия политик, созданных за последний день для всех ресурсов в подписке в текущем контексте сеанса. Команда ограничивает результаты, возвращаемые фильтрацией на основе действия определения политики (включая действия запрета или аудита), а также расположение ресурсов (исключает расположение eastus).

Параметры

-DefaultProfile

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

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

-Filter

Выражение фильтра с помощью нотации OData.

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

-From

Отформатированная метка времени ISO 8601, указывающая время начала интервала для запроса. Если параметр не указан, по умолчанию значение параметра To равно 1 день.

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

-ManagementGroupName

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

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

-PolicyAssignmentName

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

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

-PolicyDefinitionName

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

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

-PolicySetDefinitionName

Имя определения набора политик.

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

-ResourceGroupName

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

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

-ResourceId

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

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

-SubscriptionId

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

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

-To

Отформатированная метка времени ISO 8601, указывающая время окончания интервала для запроса. Если не указано, по умолчанию используется время запроса.

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

-Top

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

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

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

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