Get-AzPolicyEvent

Ссылка

Модуль:: Az.PolicyInsights

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

Синтаксис

Get-AzPolicyEvent
   [-SubscriptionId <String>]
   [-Top <Int32>]
   [-OrderBy <String>]
   [-Select <String>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-Apply <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyEvent
   -ManagementGroupName <String>
   [-Top <Int32>]
   [-OrderBy <String>]
   [-Select <String>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-Apply <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyEvent
   [-SubscriptionId <String>]
   -ResourceGroupName <String>
   [-Top <Int32>]
   [-OrderBy <String>]
   [-Select <String>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-Apply <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyEvent
   [-SubscriptionId <String>]
   -PolicySetDefinitionName <String>
   [-Top <Int32>]
   [-OrderBy <String>]
   [-Select <String>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-Apply <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyEvent
   [-SubscriptionId <String>]
   -PolicyDefinitionName <String>
   [-Top <Int32>]
   [-OrderBy <String>]
   [-Select <String>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-Apply <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyEvent
   [-SubscriptionId <String>]
   -PolicyAssignmentName <String>
   [-Top <Int32>]
   [-OrderBy <String>]
   [-Select <String>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-Apply <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyEvent
   [-SubscriptionId <String>]
   -ResourceGroupName <String>
   -PolicyAssignmentName <String>
   [-Top <Int32>]
   [-OrderBy <String>]
   [-Select <String>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-Apply <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Get-AzPolicyEvent
   -ResourceId <String>
   [-Top <Int32>]
   [-OrderBy <String>]
   [-Select <String>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-Apply <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Описание

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

Примеры

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

Get-AzPolicyEvent

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

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

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

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

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

Get-AzPolicyEvent -ManagementGroupName "myManagementGroup"

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

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

Get-AzPolicyEvent -ResourceGroupName "myResourceGroup"

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

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

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

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

Пример 6. Получение событий политики для ресурса

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Get-AzPolicyEvent -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"

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

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

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

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

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

Get-AzPolicyEvent -ResourceGroupName "myResourceGroup" -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"

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

Пример 14. Получение событий политики в текущей области подписки с параметрами запроса OrderBy, Top и Select

Get-AzPolicyEvent -OrderBy "Timestamp desc, PolicyAssignmentName asc" -Top 5 -Select "Timestamp, ResourceId, PolicyAssignmentId, PolicySetDefinitionId, PolicyDefinitionId"

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

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

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

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

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

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

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

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

Get-AzPolicyEvent -Apply "aggregate(`$count as NumberOfRecords)"

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

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

Get-AzPolicyEvent -Filter "PolicyDefinitionAction eq 'audit' or PolicyDefinitionAction eq 'deny'" -Apply "groupby((PolicyAssignmentId, PolicyDefinitionId, PolicyDefinitionAction, ResourceId), aggregate(`$count as NumEvents))" -OrderBy "NumEvents desc" -Top 5

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

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

Get-AzPolicyEvent -Filter "PolicyDefinitionAction eq 'audit' or PolicyDefinitionAction eq 'deny'" -Apply "groupby((ResourceId))"

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

Get-AzPolicyEvent -Filter "PolicyDefinitionAction eq 'deny'" -Apply "groupby((PolicyAssignmentId, PolicyDefinitionId, ResourceId))/groupby((PolicyAssignmentId, PolicyDefinitionId), aggregate(`$count as NumDeniedResources))" -OrderBy "NumDeniedResources desc" -Top 5

Возвращает записи событий политики, созданные за последний день для всех ресурсов в подписке в текущем контексте сеанса. Команда ограничивает результаты, возвращаемые фильтрацией на основе действия определения политики (включая только события запрета). Сначала он группируют результаты на основе назначения политики, определения политики и идентификатора ресурса. Затем он также группирует результаты этой группировки с теми же свойствами, за исключением идентификатора ресурса, и вычисляет количество записей в каждой из этих групп, возвращаемых внутри свойства AdditionalProperties. Он упорядочивает результаты по агрегации счетчиков в порядке убывания и принимает только 5 лучших из перечисленных в этом порядке. Это создает первые 5 политик запрета с наибольшим количеством запрещенных ресурсов.

Параметры

-Apply

Примените выражение для агрегирования с помощью нотации OData.

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

-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

-OrderBy

Выражение упорядочивания с помощью нотации OData. Одно или несколько имен столбцов, разделенных запятыми, с необязательным "desc" (по умолчанию) или asc.

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

-Select

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

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

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

String

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

PolicyEvent

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