Dela via

Get-AzPolicyStateSummary

  • Referens
Modul:
Az.PolicyInsights

Hämtar den senaste sammanfattningen av principefterlevnadstillstånd för resurser.

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

Description

Hämtar en sammanfattning av de senaste principefterlevnadstillståndsnumren i olika omfång, uppdelade i principtilldelningar och principdefinitioner. Den innehåller endast icke-kompatibla principtillstånd.

Exempel

Exempel 1: Få den senaste sammanfattningen av icke-kompatibla principtillstånd i det aktuella prenumerationsomfånget

Get-AzPolicyStateSummary

Hämtar sammanfattningsvyn över de senaste principefterlevnadstillstånden som genererades under den senaste dagen för alla resurser i prenumerationen i den aktuella sessionskontexten.

Exempel 2: Få den senaste sammanfattningen av icke-kompatibla principtillstånd i det angivna prenumerationsomfånget

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

Hämtar sammanfattningsvyn över de senaste principefterlevnadstillstånden som genererades under den senaste dagen för alla resurser i den angivna prenumerationen.

Exempel 3: Få den senaste sammanfattningen av icke-kompatibla principtillstånd i hanteringsgruppens omfång

Get-AzPolicyStateSummary -ManagementGroupName "myManagementGroup"

Hämtar sammanfattningsvyn över de senaste principefterlevnadstillstånden som genererades under den senaste dagen för alla resurser i den angivna hanteringsgruppen.

Exempel 4: Få den senaste sammanfattningen av icke-kompatibla principtillstånd i resursgruppsomfånget i den aktuella prenumerationen

Get-AzPolicyStateSummary -ResourceGroupName "myResourceGroup"

Hämtar sammanfattningsvyn över de senaste principefterlevnadstillstånden som genererades under den senaste dagen för alla resurser i den angivna resursgruppen (i prenumerationen i den aktuella sessionskontexten).

Exempel 5: Få den senaste sammanfattningen av icke-kompatibla principtillstånd i resursgruppsomfånget i den angivna prenumerationen

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

Hämtar sammanfattningsvyn över de senaste principefterlevnadstillstånden som genererades under den senaste dagen för alla resurser i den angivna resursgruppen (i den angivna prenumerationen).

Exempel 6: Få den senaste sammanfattningen av icke-kompatibla principtillstånd för en resurs

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

Hämtar sammanfattningsvyn över de senaste principefterlevnadstillstånden som genererades under den senaste dagen för den angivna resursen.

Exempel 7: Få den senaste sammanfattningen av icke-kompatibla principtillstånd för en principuppsättningsdefinition i den aktuella prenumerationen

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

Hämtar sammanfattningsvyn över de senaste principefterlevnadstillstånden som genererades under den senaste dagen för alla resurser (inom klientorganisationen i den aktuella sessionskontexten) som påverkas av den angivna principuppsättningsdefinitionen (som finns i prenumerationen i den aktuella sessionskontexten).

Exempel 8: Få den senaste sammanfattningen av icke-kompatibla principtillstånd för en principuppsättningsdefinition i den angivna prenumerationen

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

Hämtar sammanfattningsvyn över de senaste principefterlevnadstillstånden som genererades under den senaste dagen för alla resurser (inom klientorganisationen i den aktuella sessionskontexten) som påverkas av den angivna principuppsättningsdefinitionen (som finns i den angivna prenumerationen).

Exempel 9: Få den senaste sammanfattningen av icke-kompatibla principtillstånd för en principdefinition i den aktuella prenumerationen

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

Hämtar sammanfattningsvyn över de senaste principefterlevnadstillstånden som genererades under den senaste dagen för alla resurser (inom klientorganisationen i den aktuella sessionskontexten) som påverkas av den angivna principdefinitionen (som finns i prenumerationen i den aktuella sessionskontexten).

Exempel 10: Få den senaste sammanfattningen av icke-kompatibla principtillstånd för en principdefinition i den angivna prenumerationen

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

Hämtar sammanfattningsvyn över de senaste principefterlevnadstillstånden som genererades under den senaste dagen för alla resurser (inom klientorganisationen i den aktuella sessionskontexten) som påverkas av den angivna principdefinitionen (som finns i den angivna prenumerationen).

Exempel 11: Få den senaste sammanfattningen av icke-kompatibla principtillstånd för en principtilldelning i den aktuella prenumerationen

Get-AzPolicyStateSummary -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"

Hämtar sammanfattningsvyn över de senaste principefterlevnadstillstånden som genererades under den senaste dagen för alla resurser (inom klientorganisationen i den aktuella sessionskontexten) som påverkas av den angivna principtilldelningen (som finns i prenumerationen i den aktuella sessionskontexten).

Exempel 12: Få den senaste sammanfattningen av icke-kompatibla principtillstånd för en principtilldelning i den angivna prenumerationen

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

Hämtar sammanfattningsvyn över de senaste principefterlevnadstillstånden som genererades under den senaste dagen för alla resurser (inom klientorganisationen i den aktuella sessionskontexten) som utförs av den angivna principtilldelningen (som finns i den angivna prenumerationen).

Exempel 13: Få den senaste sammanfattningen av icke-kompatibla principtillstånd för en principtilldelning i den angivna resursgruppen i den aktuella prenumerationen

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

Hämtar sammanfattningsvyn över de senaste principefterlevnadstillstånden som genererades under den senaste dagen för alla resurser (inom klientorganisationen i den aktuella sessionskontexten) som påverkas av den angivna principtilldelningen (som finns i resursgruppen i prenumerationen i den aktuella sessionskontexten).

Exempel 14: Få den senaste sammanfattningen av icke-kompatibla principtillstånd i det aktuella prenumerationsomfånget, med alternativet Toppfråga

Get-AzPolicyStateSummary -Top 5

Hämtar sammanfattningsvyn över de senaste principefterlevnadstillstånden som genererades under den senaste dagen för alla resurser i prenumerationen i den aktuella sessionskontexten. Kommandot beställer principtilldelningssammanfattningarna i resultatet efter icke-kompatibla resursantal i fallande ordning och tar endast de 5 främsta av dessa principtilldelningssammanfattningar.

Exempel 15: Få den senaste sammanfattningen av icke-kompatibla principtillstånd i det aktuella prenumerationsomfånget med frågealternativen Från och Till

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

Hämtar sammanfattningsvyn över de senaste principefterlevnadstillstånden som genererats inom det datumintervall som angetts för alla resurser i prenumerationen i den aktuella sessionskontexten.

Exempel 16: Hämta den senaste sammanfattningen av icke-kompatibla principtillstånd i det aktuella prenumerationsomfånget med alternativet Filtrera fråga

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

Hämtar sammanfattningsvyn över de senaste principefterlevnadstillstånden som genererades under den senaste dagen för alla resurser i prenumerationen i den aktuella sessionskontexten. Kommandot begränsar de resultat som returneras genom filtrering baserat på principdefinitionsåtgärd (inklusive neka- eller granskningsåtgärder) och resursplats (exkluderar platsen eastus).

Parametrar

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Filter

Filtrera uttryck med OData-notation.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-From

ISO 8601-formaterad tidsstämpel som anger starttiden för intervallet som ska frågas. Om det inte anges är parametervärdet "Till" som standard minus 1 dag.

Typ:DateTime
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ManagementGroupName

Namn på hanteringsgrupp.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PolicyAssignmentName

Namn på principtilldelning.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PolicyDefinitionName

Namn på principdefinition.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-PolicySetDefinitionName

Definitionsnamn för principuppsättning.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourceGroupName

Namn på resursgrupp.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourceId

Resurs-ID.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SubscriptionId

Prenumerations-ID.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-To

ISO 8601-formaterad tidsstämpel som anger sluttiden för intervallet som ska frågas. När det inte anges är standardtiden för begäran.

Typ:DateTime
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Top

Maximalt antal poster som ska returneras.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

Utdata

PolicyStateSummary