Condividi tramite

Get-AzPolicyStateSummary

  • Riferimento
Modulo:
Az.PolicyInsights

Ottiene il riepilogo degli stati di conformità dei criteri più recenti per le risorse.

Sintassi

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

Descrizione

Ottiene una visualizzazione riepilogativa dei numeri di stato di conformità dei criteri più recenti in vari ambiti, suddivisi in assegnazioni di criteri e definizioni di criteri. Include solo gli stati dei criteri non conformi.

Esempio

Esempio 1: Ottenere il riepilogo degli stati dei criteri non conformi più recenti nell'ambito della sottoscrizione corrente

Get-AzPolicyStateSummary

Ottiene la visualizzazione riepilogativa degli stati di conformità dei criteri più recenti generati nell'ultimo giorno per tutte le risorse all'interno della sottoscrizione nel contesto sessione corrente.

Esempio 2: Ottenere il riepilogo degli stati dei criteri non conformi più recenti nell'ambito della sottoscrizione specificato

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

Ottiene la visualizzazione di riepilogo degli stati di conformità dei criteri più recenti generati nell'ultimo giorno per tutte le risorse all'interno della sottoscrizione specificata.

Esempio 3: Ottenere il riepilogo degli stati dei criteri non conformi più recenti nell'ambito del gruppo di gestione

Get-AzPolicyStateSummary -ManagementGroupName "myManagementGroup"

Ottiene la visualizzazione riepilogativa degli stati di conformità dei criteri più recenti generati nell'ultimo giorno per tutte le risorse all'interno del gruppo di gestione specificato.

Esempio 4: Ottenere il riepilogo degli stati dei criteri non conformi più recenti nell'ambito del gruppo di risorse nella sottoscrizione corrente

Get-AzPolicyStateSummary -ResourceGroupName "myResourceGroup"

Ottiene la visualizzazione di riepilogo degli stati di conformità dei criteri più recenti generati nell'ultimo giorno per tutte le risorse all'interno del gruppo di risorse specificato (nella sottoscrizione nel contesto sessione corrente).

Esempio 5: Ottenere il riepilogo degli stati dei criteri non conformi più recenti nell'ambito del gruppo di risorse nella sottoscrizione specificata

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

Ottiene la visualizzazione riepilogativa degli stati di conformità dei criteri più recenti generati nell'ultimo giorno per tutte le risorse all'interno del gruppo di risorse specificato (nella sottoscrizione specificata).

Esempio 6: Ottenere il riepilogo degli stati dei criteri non conformi più recenti per una risorsa

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

Ottiene la visualizzazione di riepilogo degli stati di conformità dei criteri più recenti generati nell'ultimo giorno per la risorsa specificata.

Esempio 7: Ottenere il riepilogo degli stati dei criteri non conformi più recenti per una definizione del set di criteri nella sottoscrizione corrente

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

Ottiene la visualizzazione di riepilogo degli stati di conformità dei criteri più recenti generati nell'ultimo giorno per tutte le risorse (all'interno del tenant nel contesto di sessione corrente) applicate dalla definizione del set di criteri specificata (presente nella sottoscrizione nel contesto sessione corrente).

Esempio 8: Ottenere il riepilogo degli stati dei criteri non conformi più recenti per una definizione del set di criteri nella sottoscrizione specificata

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

Ottiene la visualizzazione di riepilogo degli stati di conformità dei criteri più recenti generati nell'ultimo giorno per tutte le risorse (all'interno del tenant nel contesto di sessione corrente) applicate dalla definizione del set di criteri specificata (presente nella sottoscrizione specificata).

Esempio 9: Ottenere il riepilogo degli stati dei criteri non conformi più recenti per una definizione di criteri nella sottoscrizione corrente

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

Ottiene la visualizzazione di riepilogo degli stati di conformità dei criteri più recenti generati nell'ultimo giorno per tutte le risorse (all'interno del tenant nel contesto sessione corrente) applicate dalla definizione di criteri specificata (presente nella sottoscrizione nel contesto sessione corrente).

Esempio 10: Ottenere il riepilogo degli stati dei criteri non conformi più recenti per una definizione di criteri nella sottoscrizione specificata

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

Ottiene la visualizzazione di riepilogo degli stati di conformità dei criteri più recenti generati nell'ultimo giorno per tutte le risorse (all'interno del tenant nel contesto di sessione corrente) applicate dalla definizione di criteri specificata (presente nella sottoscrizione specificata).

Esempio 11: Ottenere il riepilogo degli stati dei criteri non conformi più recenti per un'assegnazione di criteri nella sottoscrizione corrente

Get-AzPolicyStateSummary -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"

Ottiene la visualizzazione di riepilogo degli stati di conformità dei criteri più recenti generati nell'ultimo giorno per tutte le risorse (all'interno del tenant nel contesto di sessione corrente) applicate dall'assegnazione di criteri specificata (presente nella sottoscrizione nel contesto sessione corrente).

Esempio 12: Ottenere il riepilogo degli stati dei criteri non conformi più recenti per un'assegnazione di criteri nella sottoscrizione specificata

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

Ottiene la visualizzazione di riepilogo degli stati di conformità dei criteri più recenti generati nell'ultimo giorno per tutte le risorse (all'interno del tenant nel contesto sessione corrente) applicate dall'assegnazione di criteri specificata (presente nella sottoscrizione specificata).

Esempio 13: Ottenere il riepilogo degli stati dei criteri non conformi più recenti per un'assegnazione di criteri nel gruppo di risorse specificato nella sottoscrizione corrente

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

Ottiene la visualizzazione di riepilogo degli stati di conformità dei criteri più recenti generati nell'ultimo giorno per tutte le risorse (all'interno del tenant nel contesto sessione corrente) applicate dall'assegnazione di criteri specificata (presente nel gruppo di risorse nella sottoscrizione nel contesto sessione corrente).

Esempio 14: Ottenere il riepilogo degli stati dei criteri non conformi più recenti nell'ambito della sottoscrizione corrente, con l'opzione Top query

Get-AzPolicyStateSummary -Top 5

Ottiene la visualizzazione riepilogativa degli stati di conformità dei criteri più recenti generati nell'ultimo giorno per tutte le risorse all'interno della sottoscrizione nel contesto sessione corrente. Il comando ordina i riepiloghi delle assegnazioni dei criteri nei risultati in base ai conteggi delle risorse non conformi in ordine decrescente e accetta solo i primi 5 di tali riepiloghi delle assegnazioni dei criteri.

Esempio 15: Ottenere il riepilogo degli stati dei criteri non conformi più recenti nell'ambito della sottoscrizione corrente, con le opzioni di query Da e A

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

Ottiene la visualizzazione di riepilogo degli stati di conformità dei criteri più recenti generati nell'intervallo di date specificato per tutte le risorse all'interno della sottoscrizione nel contesto sessione corrente.

Esempio 16: Ottenere il riepilogo degli stati dei criteri non conformi più recenti nell'ambito della sottoscrizione corrente, con l'opzione Filtra query

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

Ottiene la visualizzazione riepilogativa degli stati di conformità dei criteri più recenti generati nell'ultimo giorno per tutte le risorse all'interno della sottoscrizione nel contesto sessione corrente. Il comando limita i risultati restituiti filtrando in base all'azione di definizione dei criteri (include azioni di negazione o controllo) e alla posizione delle risorse (esclude eastus location).

Parametri

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Filter

Filtrare l'espressione usando la notazione OData.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-From

Timestamp formattato ISO 8601 che specifica l'ora di inizio dell'intervallo su cui eseguire la query. Se non specificato, per impostazione predefinita viene impostato il valore del parametro 'To' meno 1 giorno.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ManagementGroupName

Nome del gruppo di gestione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PolicyAssignmentName

Nome dell'assegnazione dei criteri.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PolicyDefinitionName

Nome della definizione dei criteri.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PolicySetDefinitionName

Nome della definizione del set di criteri.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ResourceGroupName

Nome del gruppo di risorse.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ResourceId

ID risorsa.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SubscriptionId

ID sottoscrizione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-To

Timestamp formattato ISO 8601 che specifica l'ora di fine dell'intervallo su cui eseguire la query. Se non specificato, il valore predefinito è l'ora della richiesta.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Top

Numero massimo di record da restituire.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

Output

PolicyStateSummary