Compartilhar via

Get-AzPolicyStateSummary

  • Referência
Módulo:
Az.PolicyInsights

Obtém o resumo dos estados de conformidade de política mais recentes para recursos.

Syntax

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>]

Description

Obtém uma exibição resumida dos números de estado de conformidade de política mais recentes em vários escopos, divididos em atribuições de política e definições de política. Inclui apenas estados de política não conformes.

Exemplos

Exemplo 1: Obter o resumo dos estados de política não compatíveis mais recentes no escopo da assinatura atual

Get-AzPolicyStateSummary

Obtém a exibição resumida dos estados de conformidade de política mais recentes gerados no último dia para todos os recursos dentro da assinatura no contexto de sessão atual.

Exemplo 2: Obter o resumo dos estados de política não compatíveis mais recentes no escopo de assinatura especificado

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

Obtém a exibição resumida dos estados de conformidade de política mais recentes gerados no último dia para todos os recursos dentro da assinatura especificada.

Exemplo 3: Obter o resumo de estados de política não compatíveis mais recente no escopo do grupo de gerenciamento

Get-AzPolicyStateSummary -ManagementGroupName "myManagementGroup"

Obtém a exibição resumida dos estados de conformidade de política mais recentes gerados no último dia para todos os recursos dentro do grupo de gerenciamento especificado.

Exemplo 4: Obter o resumo de estados de política não compatíveis mais recente no escopo do grupo de recursos na assinatura atual

Get-AzPolicyStateSummary -ResourceGroupName "myResourceGroup"

Obtém a exibição resumida dos estados de conformidade de política mais recentes gerados no último dia para todos os recursos dentro do grupo de recursos especificado (na assinatura no contexto da sessão atual).

Exemplo 5: Obter o resumo de estados de política não compatível mais recente no escopo do grupo de recursos na assinatura especificada

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

Obtém a exibição resumida dos estados de conformidade de política mais recentes gerados no último dia para todos os recursos dentro do grupo de recursos especificado (na assinatura especificada).

Exemplo 6: Obter o resumo de estados de política não compatível mais recente para um recurso

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

Obtém a exibição resumida dos estados de conformidade de política mais recentes gerados no último dia para o recurso especificado.

Exemplo 7: Obter o resumo de estados de política não compatíveis mais recente para uma definição de conjunto de políticas na assinatura atual

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

Obtém a exibição resumida dos estados de conformidade de política mais recentes gerados no último dia para todos os recursos (dentro do locatário no contexto da sessão atual) afetados pela definição do conjunto de políticas especificado (que existe na assinatura no contexto da sessão atual).

Exemplo 8: Obter o resumo de estados de política não compatível mais recente para uma definição de conjunto de políticas na assinatura especificada

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

Obtém a exibição resumida dos estados de conformidade de política mais recentes gerados no último dia para todos os recursos (dentro do locatário no contexto da sessão atual) afetados pela definição de conjunto de políticas especificada (que existe na assinatura especificada).

Exemplo 9: Obter o resumo de estados de política não compatível mais recente para uma definição de política na assinatura atual

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

Obtém a exibição resumida dos estados de conformidade de política mais recentes gerados no último dia para todos os recursos (dentro do locatário no contexto da sessão atual) afetados pela definição de política especificada (que existe na assinatura no contexto da sessão atual).

Exemplo 10: Obter o resumo de estados de política não compatível mais recente para uma definição de política na assinatura especificada

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

Obtém a exibição resumida dos estados de conformidade de política mais recentes gerados no último dia para todos os recursos (dentro do locatário no contexto da sessão atual) afetados pela definição de política especificada (que existe na assinatura especificada).

Exemplo 11: Obter o resumo de estados de política não compatível mais recente para uma atribuição de política na assinatura atual

Get-AzPolicyStateSummary -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"

Obtém a exibição resumida dos estados de conformidade de política mais recentes gerados no último dia para todos os recursos (dentro do locatário no contexto da sessão atual) afetados pela atribuição de política especificada (que existe na assinatura no contexto da sessão atual).

Exemplo 12: Obter o resumo de estados de política não compatível mais recente para uma atribuição de política na assinatura especificada

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

Obtém a exibição resumida dos estados de conformidade de política mais recentes gerados no último dia para todos os recursos (dentro do locatário no contexto da sessão atual) afetados pela atribuição de política especificada (que existe na assinatura especificada).

Exemplo 13: Obter o resumo de estados de política não compatível mais recente para uma atribuição de política no grupo de recursos especificado na assinatura atual

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

Obtém a exibição resumida dos estados de conformidade de política mais recentes gerados no último dia para todos os recursos (dentro do locatário no contexto da sessão atual) afetados pela atribuição de política especificada (que existe no grupo de recursos na assinatura no contexto da sessão atual).

Exemplo 14: Obter o resumo de estados de política não compatível mais recente no escopo de assinatura atual, com a opção de consulta Principal

Get-AzPolicyStateSummary -Top 5

Obtém a exibição resumida dos estados de conformidade de política mais recentes gerados no último dia para todos os recursos dentro da assinatura no contexto de sessão atual. O comando ordena os resumos de atribuição de política nos resultados por contagens de recursos não compatíveis em ordem decrescente e obtém apenas os 5 principais desses resumos de atribuição de política.

Exemplo 15: Obter o resumo dos estados de política não compatíveis mais recentes no escopo de assinatura atual, com as opções de consulta De e Para

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

Obtém a exibição resumida dos estados de conformidade de política mais recentes gerados dentro do intervalo de datas especificado para todos os recursos dentro da assinatura no contexto da sessão atual.

Exemplo 16: Obter o resumo de estados de política não compatível mais recente no escopo de assinatura atual, com a opção de consulta Filtrar

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

Obtém a exibição resumida dos estados de conformidade de política mais recentes gerados no último dia para todos os recursos dentro da assinatura no contexto de sessão atual. O comando limita os resultados retornados pela filtragem com base na ação de definição de política (inclui ações de negação ou auditoria) e no local do recurso (exclui o local eastus).

Parâmetros

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Filter

Expressão de filtro usando notação OData.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-From

Carimbo de data/hora formatado ISO 8601 especificando a hora de início do intervalo para consulta. Quando não especificado, o padrão é o valor do parâmetro 'Para' menos 1 dia.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ManagementGroupName

Nome do grupo de gerenciamento.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PolicyAssignmentName

Nome da atribuição de política.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PolicyDefinitionName

Nome da definição de política.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PolicySetDefinitionName

Nome da definição do conjunto de políticas.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Nome do grupo de recursos.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

ID do recurso.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SubscriptionId

ID da assinatura.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-To

Carimbo de data/hora formatado ISO 8601 especificando a hora de término do intervalo a ser consultado. Quando não especificado, o padrão é o tempo de solicitação.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Top

Número máximo de registros a serem retornados.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Saídas

PolicyStateSummary