Get-AzPolicyStateSummary
Ruft die aktuelle Zusammenfassung der Richtliniencompliancestatus für Ressourcen ab.
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>] Beschreibung
Ruft eine Zusammenfassungsansicht der neuesten Richtliniencompliancestatusnummern in verschiedenen Bereichen ab, aufgeschlüsselt in Richtlinienzuweisungen und Richtliniendefinitionen. Sie enthält nur nicht kompatible Richtlinienzustände.
Beispiele
Beispiel 1: Abrufen der neuesten Zusammenfassung nicht kompatibler Richtlinienzustände im aktuellen Abonnementbereich
Get-AzPolicyStateSummaryRuft die Zusammenfassungsansicht der neuesten Richtlinienkompatibilitätszustände ab, die am letzten Tag für alle Ressourcen innerhalb des Abonnements im aktuellen Sitzungskontext generiert wurden.
Beispiel 2: Abrufen der neuesten Zusammenfassung nicht kompatibler Richtlinienzustände im angegebenen Abonnementbereich
Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5"Ruft die Zusammenfassungsansicht der neuesten Richtlinienkompatibilitätszustände ab, die am letzten Tag für alle Ressourcen innerhalb des angegebenen Abonnements generiert wurden.
Beispiel 3: Abrufen der neuesten Zusammenfassung nicht kompatibler Richtlinienzustände im Verwaltungsgruppenbereich
Get-AzPolicyStateSummary -ManagementGroupName "myManagementGroup"Ruft die Zusammenfassungsansicht der neuesten Richtlinienkompatibilitätszustände ab, die am letzten Tag für alle Ressourcen innerhalb der angegebenen Verwaltungsgruppe generiert wurden.
Beispiel 4: Abrufen der neuesten Zusammenfassung nicht kompatibler Richtlinienzustände im Ressourcengruppenbereich im aktuellen Abonnement
Get-AzPolicyStateSummary -ResourceGroupName "myResourceGroup"Ruft die Zusammenfassungsansicht der neuesten Richtlinienkompatibilitätszustände ab, die am letzten Tag für alle Ressourcen innerhalb der angegebenen Ressourcengruppe (im Abonnement im aktuellen Sitzungskontext) generiert wurden.
Beispiel 5: Abrufen der neuesten Zusammenfassung nicht kompatibler Richtlinienzustände im Ressourcengruppenbereich im angegebenen Abonnement
Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -ResourceGroupName "myResourceGroup"Ruft die Zusammenfassungsansicht der neuesten Richtlinienkompatibilitätszustände ab, die am letzten Tag für alle Ressourcen innerhalb der angegebenen Ressourcengruppe (im angegebenen Abonnement) generiert wurden.
Beispiel 6: Abrufen der neuesten Zusammenfassung nicht kompatibler Richtlinienzustände für eine Ressource
Get-AzPolicyStateSummary -ResourceId "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myResourceGroup/providers/Microsoft.EventHub/namespaces/myns1/eventhubs/eh1/consumergroups/cg1"Ruft die Zusammenfassungsansicht der neuesten Richtlinienkompatibilitätszustände ab, die am letzten Tag für die angegebene Ressource generiert wurden.
Beispiel 7: Abrufen der neuesten Zusammenfassung nicht kompatibler Richtlinienzustände für eine Richtliniensatzdefinition im aktuellen Abonnement
Get-AzPolicyStateSummary -PolicySetDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"Ruft die Zusammenfassungsansicht der neuesten Richtlinienkompatibilitätszustände ab, die am letzten Tag für alle Ressourcen (innerhalb des Mandanten im aktuellen Sitzungskontext) generiert wurden, die von der angegebenen Richtliniensatzdefinition (die im Abonnement im aktuellen Sitzungskontext vorhanden ist).
Beispiel 8: Abrufen der neuesten Zusammenfassung nicht kompatibler Richtlinienzustände für eine Richtliniensatzdefinition im angegebenen Abonnement
Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -PolicySetDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"Ruft die Zusammenfassungsansicht der neuesten Richtlinienkompatibilitätszustände ab, die am letzten Tag für alle Ressourcen (innerhalb des Mandanten im aktuellen Sitzungskontext) generiert wurden, die von der angegebenen Richtliniensatzdefinition (die im angegebenen Abonnement vorhanden ist).
Beispiel 9: Abrufen der neuesten Zusammenfassung nicht konformer Richtlinienzustände für eine Richtliniendefinition im aktuellen Abonnement
Get-AzPolicyStateSummary -PolicyDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"Ruft die Zusammenfassungsansicht der neuesten Richtlinienkompatibilitätszustände ab, die am letzten Tag für alle Ressourcen (innerhalb des Mandanten im aktuellen Sitzungskontext) generiert wurden, die von der angegebenen Richtliniendefinition (die im Abonnement im aktuellen Sitzungskontext vorhanden ist).
Beispiel 10: Abrufen der neuesten Zusammenfassung nicht konformer Richtlinienzustände für eine Richtliniendefinition im angegebenen Abonnement
Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -PolicyDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"Ruft die Zusammenfassungsansicht der neuesten Richtlinienkompatibilitätszustände ab, die am letzten Tag für alle Ressourcen (innerhalb des Mandanten im aktuellen Sitzungskontext) generiert wurden, die von der angegebenen Richtliniendefinition (die im angegebenen Abonnement vorhanden ist).
Beispiel 11: Abrufen der neuesten Zusammenfassung nicht konformer Richtlinienzustände für eine Richtlinienzuweisung im aktuellen Abonnement
Get-AzPolicyStateSummary -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"Ruft die Zusammenfassungsansicht der neuesten Richtlinienkompatibilitätszustände ab, die am letzten Tag für alle Ressourcen (innerhalb des Mandanten im aktuellen Sitzungskontext) generiert wurden, die von der angegebenen Richtlinienzuweisung (die im Abonnement im aktuellen Sitzungskontext vorhanden ist).
Beispiel 12: Abrufen der neuesten Zusammenfassung nicht konformer Richtlinienzustände für eine Richtlinienzuweisung im angegebenen Abonnement
Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"Ruft die Zusammenfassungsansicht der neuesten Richtlinienkompatibilitätszustände ab, die am letzten Tag für alle Ressourcen (innerhalb des Mandanten im aktuellen Sitzungskontext) generiert wurden, die von der angegebenen Richtlinienzuweisung (die im angegebenen Abonnement vorhanden ist).
Beispiel 13: Abrufen der neuesten Zusammenfassung nicht konformer Richtlinienzustände für eine Richtlinienzuordnung in der angegebenen Ressourcengruppe im aktuellen Abonnement
Get-AzPolicyStateSummary -ResourceGroupName "myResourceGroup" -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"Ruft die Zusammenfassungsansicht der neuesten Richtlinienkompatibilitätszustände ab, die am letzten Tag für alle Ressourcen (innerhalb des Mandanten im aktuellen Sitzungskontext) generiert wurden, die von der angegebenen Richtlinienzuweisung (die in der Ressourcengruppe im Abonnement im aktuellen Sitzungskontext vorhanden ist).
Beispiel 14: Abrufen der neuesten Zusammenfassung nicht kompatibler Richtlinienzustände im aktuellen Abonnementbereich mit der Option "Top-Abfrage"
Get-AzPolicyStateSummary -Top 5Ruft die Zusammenfassungsansicht der neuesten Richtlinienkompatibilitätszustände ab, die am letzten Tag für alle Ressourcen innerhalb des Abonnements im aktuellen Sitzungskontext generiert wurden. Der Befehl sortiert die Richtlinienzuweisungszusammenfassungen in den Ergebnissen nach nicht kompatiblen Ressourcenanzahlen in absteigender Reihenfolge und nimmt nur die 5 top 5 dieser Richtlinienzuweisungszusammenfassungen auf.
Beispiel 15: Abrufen der neuesten Zusammenfassung nicht kompatibler Richtlinienzustände im aktuellen Abonnementbereich mit "Von" und "Von" mit den Abfrageoptionen "Von" und "An"
Get-AzPolicyStateSummary -From "2018-03-08 00:00:00Z" -To "2018-03-15 00:00:00Z"Ruft die Zusammenfassungsansicht der neuesten Richtlinienkompatibilitätszustände ab, die innerhalb des datumsbereichs für alle Ressourcen innerhalb des Abonnements im aktuellen Sitzungskontext angegeben wurden.
Beispiel 16: Abrufen der neuesten Zusammenfassung nicht kompatibler Richtlinienzustände im aktuellen Abonnementbereich mit Filterabfrageoption
Get-AzPolicyStateSummary -Filter "(PolicyDefinitionAction eq 'deny' or PolicyDefinitionAction eq 'audit') and ResourceLocation ne 'eastus'"Ruft die Zusammenfassungsansicht der neuesten Richtlinienkompatibilitätszustände ab, die am letzten Tag für alle Ressourcen innerhalb des Abonnements im aktuellen Sitzungskontext generiert wurden. Der Befehl beschränkt die ergebnisse, die durch Filtern basierend auf der Richtliniendefinitionsaktion zurückgegeben werden (einschließlich Verweigerungs- oder Überwachungsaktionen) und ressourcenspeicherort (schließt ostus-Standort aus).
Parameter
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Filter
Filterausdruck mit OData-Notation.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-From
Iso 8601 formatierter Zeitstempel, der die Startzeit des abfrageintervalls angibt. Wenn nicht angegeben, wird standardmäßig der Parameterwert "To" minus 1 Tag festgelegt.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ManagementGroupName
Verwaltungsgruppenname.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PolicyAssignmentName
Name der Richtlinienzuweisung.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PolicyDefinitionName
Richtliniendefinitionsname.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PolicySetDefinitionName
Richtliniensatzdefinitionsname.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceGroupName
Ressourcengruppenname
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ResourceId
Ressourcen-ID
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-SubscriptionId
Abonnement-ID
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-To
ISO 8601-formatierter Zeitstempel, der die Endzeit des abzufragenden Intervalls angibt. Wenn sie nicht angegeben ist, wird standardmäßig der Zeitpunkt der Anforderung angegeben.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Top
Maximale Anzahl der zurückzugebenden Datensätze.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
Ausgaben
Ähnliche Themen
Azure PowerShell
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für