Partilhar via

Get-AzPolicyStateSummary

  • Referência
Módulo:
Az.PolicyInsights

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

Sintaxe

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 visão resumida dos números de estado de conformidade de política mais recentes em vários escopos, divididos em atribuições 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 atual da assinatura

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 dos estados de política não compatíveis mais recentes 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 dos estados de política não compatíveis mais recentes 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 de sessão atual).

Exemplo 5: Obter o resumo dos estados de política não compatíveis mais recentes 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 dos estados de política não compatíveis mais recentes 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 dos estados de política não compatíveis mais recentes 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 de sessão atual) efetuados pela definição de conjunto de políticas especificada (que existe na assinatura no contexto de sessão atual).

Exemplo 8: Obter o resumo mais recente dos estados de política não compatíveis 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 de sessão atual) efetuados pela definição de conjunto de políticas especificada (que existe na assinatura especificada).

Exemplo 9: Obter o resumo mais recente dos estados de política não compatíveis 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 de sessão atual) afetados pela definição de política especificada (que existe na assinatura no contexto de sessão atual).

Exemplo 10: Obter o resumo mais recente dos estados de política não compatíveis 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 de sessão atual) efetuados pela definição de política especificada (que existe na assinatura especificada).

Exemplo 11: Obter o resumo dos estados de política não compatíveis mais recentes 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 de sessão atual) efetuados pela atribuição de política especificada (que existe na assinatura no contexto de sessão atual).

Exemplo 12: Obter o resumo dos estados de política não compatíveis mais recentes 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 de sessão atual) efetuados pela atribuição de política especificada (que existe na assinatura especificada).

Exemplo 13: Obter o resumo dos estados de política não compatíveis mais recentes 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 de sessão atual) efetuados pela atribuição de política especificada (que existe no grupo de recursos na assinatura no contexto de sessão atual).

Exemplo 14: Obtenha o resumo dos estados de política não compatíveis mais recentes no escopo da assinatura atual, com a opção 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 leva apenas os 5 primeiros desses resumos de atribuição de política.

Exemplo 15: Obtenha o resumo dos estados de política não compatíveis mais recentes no escopo da 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 de sessão atual.

Exemplo 16: Obtenha o resumo dos estados de política não compatíveis mais recentes no escopo da 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 filtrando 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 comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Filter

Filtrar expressão usando notação OData.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-From

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

Tipo:DateTime
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ManagementGroupName

Nome do grupo de gerenciamento.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PolicyAssignmentName

Nome da atribuição de política.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PolicyDefinitionName

Nome da definição da política.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-PolicySetDefinitionName

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ResourceGroupName

Nome do grupo de recursos.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ResourceId

ID do recurso.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-SubscriptionId

ID da subscrição.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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 da solicitação.

Tipo:DateTime
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Top

Número máximo de registos a devolver.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Saídas

PolicyStateSummary