Udostępnij za pośrednictwem

Get-AzPolicyStateSummary

  • Odwołanie
Moduł:
Az.PolicyInsights

Pobiera podsumowanie najnowszych stanów zgodności zasad dla zasobów.

Składnia

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

Opis

Pobiera widok podsumowania najnowszych numerów stanu zgodności zasad w różnych zakresach podzielonych na przypisania zasad i definicje zasad. Zawiera tylko niezgodne stany zasad.

Przykłady

Przykład 1. Podsumowanie najnowszych niezgodnych stanów zasad w bieżącym zakresie subskrypcji

Get-AzPolicyStateSummary

Pobiera widok podsumowania najnowszych stanów zgodności zasad wygenerowanych w ostatnim dniu dla wszystkich zasobów w ramach subskrypcji w bieżącym kontekście sesji.

Przykład 2. Podsumowanie najnowszych niezgodnych stanów zasad w określonym zakresie subskrypcji

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

Pobiera widok podsumowania najnowszych stanów zgodności zasad wygenerowanych w ostatnim dniu dla wszystkich zasobów w ramach określonej subskrypcji.

Przykład 3. Podsumowanie najnowszych niezgodnych stanów zasad w zakresie grupy zarządzania

Get-AzPolicyStateSummary -ManagementGroupName "myManagementGroup"

Pobiera widok podsumowania najnowszych stanów zgodności zasad wygenerowanych w ostatnim dniu dla wszystkich zasobów w określonej grupie zarządzania.

Przykład 4. Podsumowanie najnowszych niezgodnych stanów zasad w zakresie grupy zasobów w bieżącej subskrypcji

Get-AzPolicyStateSummary -ResourceGroupName "myResourceGroup"

Pobiera widok podsumowania najnowszych stanów zgodności zasad wygenerowanych w ostatnim dniu dla wszystkich zasobów w określonej grupie zasobów (w subskrypcji w bieżącym kontekście sesji).

Przykład 5: Podsumowanie najnowszych niezgodnych stanów zasad w zakresie grupy zasobów w określonej subskrypcji

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

Pobiera widok podsumowania najnowszych stanów zgodności zasad wygenerowanych w ciągu ostatniego dnia dla wszystkich zasobów w określonej grupie zasobów (w określonej subskrypcji).

Przykład 6: Podsumowanie najnowszych niezgodnych stanów zasad dla zasobu

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

Pobiera widok podsumowania najnowszych stanów zgodności zasad wygenerowanych w ostatnim dniu dla określonego zasobu.

Przykład 7. Podsumowanie najnowszych niezgodnych stanów zasad dla definicji zestawu zasad w bieżącej subskrypcji

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

Pobiera widok podsumowania najnowszych stanów zgodności zasad wygenerowanych w ostatnim dniu dla wszystkich zasobów (w dzierżawie w bieżącym kontekście sesji) objętych określoną definicją zestawu zasad (która istnieje w subskrypcji w bieżącym kontekście sesji).

Przykład 8: Podsumowanie najnowszych niezgodnych stanów zasad dla definicji zestawu zasad w określonej subskrypcji

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

Pobiera widok podsumowania najnowszych stanów zgodności zasad wygenerowanych w ostatnim dniu dla wszystkich zasobów (w dzierżawie w bieżącym kontekście sesji) objętych określoną definicją zestawu zasad (która istnieje w określonej subskrypcji).

Przykład 9: Podsumowanie najnowszych niezgodnych stanów zasad dla definicji zasad w bieżącej subskrypcji

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

Pobiera widok podsumowania najnowszych stanów zgodności zasad wygenerowanych w ciągu ostatniego dnia dla wszystkich zasobów (w dzierżawie w bieżącym kontekście sesji) objętych określoną definicją zasad (która istnieje w subskrypcji w bieżącym kontekście sesji).

Przykład 10: Podsumowanie najnowszych niezgodnych stanów zasad dla definicji zasad w określonej subskrypcji

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

Pobiera widok podsumowania najnowszych stanów zgodności zasad wygenerowanych w ostatnim dniu dla wszystkich zasobów (w dzierżawie w bieżącym kontekście sesji) objętych określoną definicją zasad (która istnieje w określonej subskrypcji).

Przykład 11: Podsumowanie najnowszych niezgodnych stanów zasad dla przypisania zasad w bieżącej subskrypcji

Get-AzPolicyStateSummary -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"

Pobiera widok podsumowania najnowszych stanów zgodności zasad wygenerowanych w ciągu ostatniego dnia dla wszystkich zasobów (w dzierżawie w bieżącym kontekście sesji) objętych określonym przypisaniem zasad (które istnieje w subskrypcji w bieżącym kontekście sesji).

Przykład 12: Podsumowanie najnowszych niezgodnych stanów zasad dla przypisania zasad w określonej subskrypcji

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

Pobiera widok podsumowania najnowszych stanów zgodności zasad wygenerowanych w ostatnim dniu dla wszystkich zasobów (w dzierżawie w bieżącym kontekście sesji) objętych określonym przypisaniem zasad (które istnieje w określonej subskrypcji).

Przykład 13: Podsumowanie najnowszych niezgodnych stanów zasad dla przypisania zasad w określonej grupie zasobów w bieżącej subskrypcji

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

Pobiera widok podsumowania najnowszych stanów zgodności zasad wygenerowanych w ostatnim dniu dla wszystkich zasobów (w dzierżawie w bieżącym kontekście sesji) objętych określonym przypisaniem zasad (które istnieje w grupie zasobów w subskrypcji w bieżącym kontekście sesji).

Przykład 14: Podsumowanie najnowszych niezgodnych stanów zasad w bieżącym zakresie subskrypcji z opcją Najważniejsze zapytanie

Get-AzPolicyStateSummary -Top 5

Pobiera widok podsumowania najnowszych stanów zgodności zasad wygenerowanych w ostatnim dniu dla wszystkich zasobów w ramach subskrypcji w bieżącym kontekście sesji. Polecenie porządkuje podsumowania przypisania zasad w wynikach przez niezgodne liczby zasobów w kolejności malejącej i przyjmuje tylko 5 pierwszych z tych podsumowań przypisań zasad.

Przykład 15: Podsumowanie najnowszych niezgodnych stanów zasad w bieżącym zakresie subskrypcji z opcjami zapytania Od i Do

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

Pobiera widok podsumowania najnowszych stanów zgodności zasad wygenerowanych w zakresie dat określonym dla wszystkich zasobów w ramach subskrypcji w bieżącym kontekście sesji.

Przykład 16: Podsumowanie najnowszych niezgodnych stanów zasad w bieżącym zakresie subskrypcji z opcją Filtrowanie zapytania

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

Pobiera widok podsumowania najnowszych stanów zgodności zasad wygenerowanych w ostatnim dniu dla wszystkich zasobów w ramach subskrypcji w bieżącym kontekście sesji. Polecenie ogranicza wyniki zwracane przez filtrowanie na podstawie akcji definicji zasad (łącznie z akcjami odmowy lub inspekcji) i lokalizacją zasobu (wyklucza lokalizację eastus).

Parametry

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Filter

Wyrażenie filtru przy użyciu notacji OData.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-From

Sygnatura czasowa w formacie ISO 8601 określająca godzinę rozpoczęcia interwału zapytania. Jeśli nie zostanie określony, wartość domyślna to "Do" parametru minus 1 dzień.

Typ:DateTime
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ManagementGroupName

Nazwa grupy zarządzania.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PolicyAssignmentName

Nazwa przypisania zasad.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PolicyDefinitionName

Nazwa definicji zasad.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-PolicySetDefinitionName

Nazwa definicji zestawu zasad.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Nazwa grupy zasobów.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResourceId

Identyfikator zasobu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SubscriptionId

Identyfikator subskrypcji.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-To

Sygnatura czasowa w formacie ISO 8601 określająca godzinę zakończenia interwału do zapytania. Jeśli nie zostanie określony, domyślnie czas żądania.

Typ:DateTime
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Top

Maksymalna liczba rekordów do zwrócenia.

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Dane wyjściowe

PolicyStateSummary