Get-AzPolicyState

Ottiene gli stati di conformità dei criteri per le risorse.

Sintassi

Get-AzPolicyState
   [-All]
   [-SubscriptionId <String>]
   [-Top <Int32>]
   [-OrderBy <String>]
   [-Select <String>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-Apply <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyState
   [-All]
   -ManagementGroupName <String>
   [-Top <Int32>]
   [-OrderBy <String>]
   [-Select <String>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-Apply <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyState
   [-All]
   [-SubscriptionId <String>]
   -ResourceGroupName <String>
   [-Top <Int32>]
   [-OrderBy <String>]
   [-Select <String>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-Apply <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyState
   [-All]
   -ResourceId <String>
   [-Top <Int32>]
   [-OrderBy <String>]
   [-Select <String>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-Apply <String>]
   [-Expand <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyState
   [-All]
   [-SubscriptionId <String>]
   -PolicySetDefinitionName <String>
   [-Top <Int32>]
   [-OrderBy <String>]
   [-Select <String>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-Apply <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyState
   [-All]
   [-SubscriptionId <String>]
   -PolicyDefinitionName <String>
   [-Top <Int32>]
   [-OrderBy <String>]
   [-Select <String>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-Apply <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyState
   [-All]
   [-SubscriptionId <String>]
   -PolicyAssignmentName <String>
   [-Top <Int32>]
   [-OrderBy <String>]
   [-Select <String>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-Apply <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyState
   [-All]
   [-SubscriptionId <String>]
   -ResourceGroupName <String>
   -PolicyAssignmentName <String>
   [-Top <Int32>]
   [-OrderBy <String>]
   [-Select <String>]
   [-From <DateTime>]
   [-To <DateTime>]
   [-Filter <String>]
   [-Apply <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Descrizione

Ottiene gli stati di conformità dei criteri per le risorse. I record di stato dei criteri possono essere sottoposti a query in vari ambiti. In base all'intervallo di tempo specificato (per impostazione predefinita all'ultimo giorno), è possibile eseguire query sugli stati dei criteri più recenti o su tutte le transizioni di stato dei criteri. È possibile calcolare i risultati, raggruppare e raggruppare le aggregazioni.

Esempio

Esempio 1: Ottenere gli stati dei criteri più recenti nell'ambito della sottoscrizione corrente

Get-AzPolicyState

Ottiene i record dello stato dei criteri più recenti generati nell'ultimo giorno per tutte le risorse all'interno della sottoscrizione nel contesto di sessione corrente.

Esempio 2: Ottenere gli stati dei criteri più recenti nell'ambito della sottoscrizione specificato

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

Ottiene i record dello stato dei criteri più recenti generati nell'ultimo giorno per tutte le risorse all'interno della sottoscrizione specificata.

Esempio 3: Ottenere tutti gli stati dei criteri nell'ambito della sottoscrizione corrente

Get-AzPolicyState -All

Ottiene tutti i record cronologici dello stato dei criteri (incluso l'ultimo) generato nell'ultimo giorno per tutte le risorse all'interno della sottoscrizione nel contesto di sessione corrente.

Esempio 4: Ottenere gli stati dei criteri più recenti nell'ambito del gruppo di gestione

Get-AzPolicyState -ManagementGroupName "myManagementGroup"

Ottiene i record di stato dei criteri più recenti generati nell'ultimo giorno per tutte le risorse all'interno del gruppo di gestione specificato.

Esempio 5: Ottenere gli stati dei criteri più recenti nell'ambito del gruppo di risorse nella sottoscrizione corrente

Get-AzPolicyState -ResourceGroupName "myResourceGroup"

Ottiene i record dello stato 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 6: Ottenere gli stati dei criteri più recenti nell'ambito del gruppo di risorse nella sottoscrizione specificata

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

Ottiene i record dello stato dei criteri più recenti generati nell'ultimo giorno per tutte le risorse all'interno del gruppo di risorse specificato (nella sottoscrizione specificata).

Esempio 7: Ottenere gli stati dei criteri più recenti per una risorsa

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

Ottiene i record dello stato dei criteri più recenti generati nell'ultimo giorno per la risorsa specificata.

Esempio 8: Ottenere gli stati dei criteri più recenti per una definizione di set di criteri nella sottoscrizione corrente

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

Ottiene i record dello stato dei criteri più recenti generati nell'ultimo giorno per tutte le risorse (all'interno del tenant nel contesto sessione corrente) applicate dalla definizione del set di criteri specificata (presente nella sottoscrizione nel contesto sessione corrente).

Esempio 9: Ottenere gli stati dei criteri più recenti per una definizione del set di criteri nella sottoscrizione specificata

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

Ottiene i record dello stato 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 10: Ottenere gli stati dei criteri più recenti per una definizione di criteri nella sottoscrizione corrente

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

Ottiene i record dello stato 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 11: Ottenere gli stati dei criteri più recenti per una definizione di criteri nella sottoscrizione specificata

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

Ottiene i record dello stato 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 12: Ottenere gli stati dei criteri più recenti per un'assegnazione di criteri nella sottoscrizione corrente

Get-AzPolicyState -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"

Ottiene i record dello stato 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 nell'ambito della sottoscrizione nella sottoscrizione nel contesto sessione corrente).

Esempio 13: Ottenere gli stati dei criteri più recenti per un'assegnazione di criteri con lo stesso ambito della sottoscrizione specificata

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

Ottiene i record dello stato 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 nell'ambito della sottoscrizione nella sottoscrizione specificata).

Esempio 14: Ottenere gli stati dei criteri più recenti per un'assegnazione di criteri nel gruppo di risorse specificato nella sottoscrizione corrente

Get-AzPolicyState -ResourceGroupName "myResourceGroup" -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"

Ottiene i record dello stato 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 15: Ottenere gli stati dei criteri più recenti nell'ambito della sottoscrizione corrente, con OrderBy, Top e Selezionare le opzioni di query

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

Ottiene i record dello stato dei criteri più recenti generati nell'ultimo giorno per tutte le risorse all'interno della sottoscrizione nel contesto di sessione corrente. Il comando ordina i risultati in base alle proprietà del nome di assegnazione di criteri e timestamp e accetta solo i primi 5 di quelli elencati in tale ordine. Viene anche selezionato per elencare solo un subset delle colonne per ogni record.

Esempio 16: Ottenere gli stati dei criteri più recenti nell'ambito della sottoscrizione corrente, con le opzioni di query Da e A

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

Ottiene i record dello stato dei criteri più recenti generati all'interno dell'intervallo di date specificato per tutte le risorse all'interno della sottoscrizione nel contesto di sessione corrente.

Esempio 17: Ottenere gli stati dei criteri più recenti nell'ambito della sottoscrizione corrente, con l'opzione Filtro query

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

Ottiene i record dello stato dei criteri più recenti generati nell'ultimo giorno per tutte le risorse all'interno della sottoscrizione nel contesto di sessione corrente. Il comando limita i risultati restituiti filtrando in base all'azione di definizione dei criteri (include azioni di negazione o controllo), lo stato di conformità (include solo lo stato non conforme) e la posizione della risorsa (esclude la posizione eastus).

Esempio 18: Ottenere gli stati dei criteri più recenti nell'ambito della sottoscrizione corrente, con Applica che specifica l'aggregazione del numero di righe

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

Ottiene il numero di record di stato dei criteri più recenti generati nell'ultimo giorno per tutte le risorse all'interno della sottoscrizione nel contesto sessione corrente. Il comando restituisce solo il conteggio dei record dello stato dei criteri, restituito all'interno della proprietà AdditionalProperties.

Esempio 19: Ottenere gli stati dei criteri più recenti nell'ambito della sottoscrizione corrente, con Applica che specifica il raggruppamento con l'aggregazione

Get-AzPolicyState -Filter "ComplianceState eq 'NonCompliant'" -Apply "groupby((PolicyAssignmentId, PolicySetDefinitionId, PolicyDefinitionReferenceId, PolicyDefinitionId), aggregate(`$count as NumStates))" -OrderBy "NumStates desc" -Top 5

Ottiene i record dello stato dei criteri più recenti generati nell'ultimo giorno per tutte le risorse all'interno della sottoscrizione nel contesto di sessione corrente. Il comando limita i risultati restituiti filtrando in base allo stato di conformità (include solo lo stato non conforme). Raggruppa i risultati in base all'assegnazione di criteri, alla definizione del set di criteri e alla definizione dei criteri e calcola il numero di record in ogni gruppo, restituito all'interno della proprietà AdditionalProperties. Ordina i risultati in base all'aggregazione conteggio in ordine decrescente e accetta solo i primi 5 di quelli elencati in tale ordine.

Esempio 20: Ottenere gli stati dei criteri più recenti nell'ambito della sottoscrizione corrente, con Applica che specifica il raggruppamento senza aggregazione

Get-AzPolicyState -Filter "ComplianceState eq 'NonCompliant'" -Apply "groupby((ResourceId))"

Ottiene i record dello stato dei criteri più recenti generati nell'ultimo giorno per tutte le risorse all'interno della sottoscrizione nel contesto di sessione corrente. Il comando limita i risultati restituiti filtrando in base allo stato di conformità (include solo lo stato non conforme). Raggruppa i risultati in base all'ID risorsa. In questo modo viene generato l'elenco di tutte le risorse all'interno della sottoscrizione non conformi per almeno un criterio.

Esempio 21: Ottenere gli stati dei criteri più recenti nell'ambito della sottoscrizione corrente, con Applica specificando più raggruppamenti

Get-AzPolicyState -Filter "ComplianceState eq 'NonCompliant'" -Apply "groupby((PolicyAssignmentId, PolicySetDefinitionId, PolicyDefinitionReferenceId, PolicyDefinitionId, ResourceId))/groupby((PolicyAssignmentId, PolicySetDefinitionId, PolicyDefinitionReferenceId, PolicyDefinitionId), aggregate(`$count as NumNonCompliantResources))" -OrderBy "NumNonCompliantResources desc" -Top 5

Ottiene i record dello stato dei criteri più recenti generati nell'ultimo giorno per tutte le risorse all'interno della sottoscrizione nel contesto di sessione corrente. Il comando limita i risultati restituiti filtrando in base allo stato di conformità (include solo lo stato non conforme). Raggruppa prima i risultati in base all'assegnazione di criteri, alla definizione del set di criteri, alla definizione dei criteri e all'ID risorsa. Quindi raggruppa ulteriormente i risultati di questo raggruppamento con le stesse proprietà ad eccezione dell'ID risorsa e calcola il numero di record in ognuno di questi gruppi, restituiti all'interno della proprietà AdditionalProperties. Ordina i risultati in base all'aggregazione conteggio in ordine decrescente e accetta solo i primi 5 di quelli elencati in tale ordine. In questo modo vengono generati i primi 5 criteri con il maggior numero di risorse non conformi.

Esempio 22: Ottenere gli stati dei criteri più recenti, inclusi i dettagli di valutazione dei criteri per una risorsa

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

Ottiene i record dello stato dei criteri più recenti generati nell'ultimo giorno per la risorsa specificata ed espandere policyEvaluationDetails.

Esempio 23: Ottenere gli stati dei criteri dei componenti più recenti per una risorsa (ad esempio, insieme di credenziali) in base a un'assegnazione di criteri in modalità provider di risorse

Get-AzPolicyState -ResourceId "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myvault" -Filter "policyAssignmentId eq '/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/providers/Microsoft.Authorization/policyAssignments/ddd8ef92e3714a5ea3d208c1'" -Expand "Components(`$filter=ComplianceState eq 'NonCompliant' or ComplianceState eq 'Compliant')"

Ottiene i record di stato dei criteri dei componenti più recenti generati nell'ultimo giorno per la risorsa specificata, data l'assegnazione di criteri in modalità provider di risorse che fa riferimento a una definizione di criteri in modalità provider di risorse.

Esempio 24: Ottenere gli stati dei criteri dei componenti più recenti per una risorsa ,ad esempio insieme di credenziali, dato un'assegnazione di iniziativa di criteri contenente una definizione di criteri in modalità provider di risorse

Get-AzPolicyState -ResourceId "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myvault" -Filter "policyAssignmentId eq '/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/providers/Microsoft.Authorization/policyAssignments/ddd8ef92e3714a5ea3d208c1' and policyDefinitionReferenceId eq 'myResourceProviderModeDefinitionReferenceId'" -Expand "Components(`$filter=ComplianceState eq 'NonCompliant' or ComplianceState eq 'Compliant')"

Ottiene i record di stato dei criteri dei componenti più recenti generati nell'ultimo giorno per la risorsa specificata, data l'assegnazione di criteri in modalità provider di risorse che fa riferimento a un'iniziativa contenente una definizione di criteri in modalità provider di risorse.

Esempio 25: Ottenere i conteggi dei componenti più recenti in base allo stato di conformità per una risorsa (ad esempio, insieme di credenziali) dato un'assegnazione di criteri in modalità provider di risorse

Get-AzPolicyState -ResourceId "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myvault" -Filter "policyAssignmentId eq '/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/providers/Microsoft.Authorization/policyAssignments/ddd8ef92e3714a5ea3d208c1'" -Expand "Components(`$filter=ComplianceState eq 'NonCompliant' or ComplianceState eq 'Compliant' or ComplianceState eq 'Conflict';`$apply=groupby((complianceState),aggregate(`$count as count)))"

Ottiene i conteggi dei componenti più recenti generati nell'ultimo giorno raggruppati in base allo stato di conformità per la risorsa specificata, in base all'assegnazione di criteri in modalità provider di risorse.

Esempio 26: Ottenere gli stati dei criteri per un'assegnazione dei criteri di ambito del gruppo di gestione

Get-AzPolicyState -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -Filter "policyAssignmentId eq '/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/ddd8ef92e3714a5ea3d208c1'"

Ottiene i record dello stato dei criteri più recenti generati nell'ultimo giorno per tutte le risorse (all'interno del tenant nel contesto di sessione corrente) nella sottoscrizione specificata interessata dall'assegnazione di criteri specificata, assegnata a un gruppo di gestione che è un predecessore della sottoscrizione specificata.

Parametri

-All

All'interno dell'intervallo di tempo specificato, ottenere tutti gli stati dei criteri anziché l'unico più recente.

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

-Apply

Applicare l'espressione per le aggregazioni usando la notazione OData.

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

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

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

-Expand

Espandere l'espressione usando la notazione OData.

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

-Filter

Filtrare l'espressione usando la notazione OData.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-ManagementGroupName

Nome del gruppo di gestione.

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

-OrderBy

Ordinamento dell'espressione utilizzando la notazione OData. Uno o più nomi di colonna delimitati da virgole con un 'desc' facoltativo (impostazione predefinita) o 'asc'.

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

-PolicyAssignmentName

Nome di un'assegnazione di criteri. Questa assegnazione di criteri deve avere esattamente lo stesso ambito del set di parametri. Non può essere un'assegnazione di criteri di ambito del gruppo di gestione. Ad esempio: se -SubscriptionId e ResourceGroupName sono specificati, l'assegnazione dei criteri deve essere assegnata a tale gruppo di risorse. Se viene specificato solo -SubscriptionId , l'assegnazione dei criteri deve essere assegnata a tale sottoscrizione.

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

-PolicyDefinitionName

Nome di una definizione di criteri. Questa definizione di criteri deve essere presente nella sottoscrizione su cui viene sottoposta una query. Non può essere una definizione di criteri di ambito del gruppo di gestione.

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

-PolicySetDefinitionName

Nome di una definizione del set di criteri. Questa definizione del set di criteri deve esistere nella sottoscrizione su cui eseguire query. Non può essere una definizione del set di criteri di ambito del gruppo di gestione.

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

-ResourceGroupName

Nome del gruppo di risorse.

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

-ResourceId

ID risorsa.

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

-Select

Selezionare l'espressione usando la notazione OData. Uno o più nomi di colonna delimitati da virgole. Limita le colonne di ogni record solo a quelle richieste.

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

-SubscriptionId

l'ID sottoscrizione.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-Top

Numero massimo di record da restituire.

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

Input

String

Output

PolicyState