Compartilhar via

Get-AzPolicyStateSummary

  • Referência
Módulo:
Az.PolicyInsights

Obtém o resumo mais recente dos estados de conformidade da política 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 exibição resumida dos últimos números de estado de conformidade da política em vários escopos, divididos em atribuições de política e definições de política. Ele inclui apenas estados de política não compatíveis.

Exemplos

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

Get-AzPolicyStateSummary

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

Exemplo 2: obter o resumo mais recente de estados de política não compatíveis no escopo da assinatura especificado

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

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

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

Get-AzPolicyStateSummary -ManagementGroupName "myManagementGroup"

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

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

Get-AzPolicyStateSummary -ResourceGroupName "myResourceGroup"

Obtém a exibição resumida dos últimos estados de conformidade de política 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 mais recente de estados de política não compatíveis 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 mais recente de estados de política não compatíveis 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 últimos estados de conformidade de política gerados no último dia para o recurso especificado.

Exemplo 7: obter o resumo mais recente de estados de política não compatíveis 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) efetuado pela definição do conjunto de políticas especificada (que existe na assinatura no contexto da sessão atual).

Exemplo 8: obter o resumo mais recente de 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) efetuado pela definição de conjunto de políticas especificada (que existe na assinatura especificada).

Exemplo 9: obter o resumo mais recente de 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) efetuado pela definição de política especificada (que existe na assinatura no contexto da sessão atual).

Exemplo 10: obter o resumo mais recente de 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) efetuado pela definição de política especificada (que existe na assinatura especificada).

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

Get-AzPolicyStateSummary -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"

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

Exemplo 12: obter o resumo mais recente de estados de política não compatíveis 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 últimos estados de conformidade de política gerados no último dia para todos os recursos (dentro do locatário no contexto de sessão atual) efetuado pela atribuição de política especificada (que existe na assinatura especificada).

Exemplo 13: obter o resumo mais recente dos estados de política não compatíveis 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) efetuado 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 mais recente dos estados de política não compatíveis no escopo da assinatura atual, com a opção de consulta Top

Get-AzPolicyStateSummary -Top 5

Obtém a exibição resumida dos últimos estados de conformidade de política 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 usa apenas cinco resumos de atribuição de política.

Exemplo 15: obter o resumo mais recente de estados de política não compatíveis no escopo da assinatura atual, com 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: obter o resumo mais recente de estados de política não compatíveis no escopo da assinatura atual, com a opção Filtrar consulta

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

Obtém a exibição resumida dos últimos estados de conformidade de política 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 na localização do recurso (exclui a localização de 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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Filter

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-From

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

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ManagementGroupName

Nome do grupo de gerenciamento.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PolicyAssignmentName

Nome da atribuição de política.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PolicyDefinitionName

Nome da definição da política.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PolicySetDefinitionName

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceGroupName

Nome do grupo de recursos.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceId

ID do recurso.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SubscriptionId

ID da assinatura.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Top

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

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Saídas