Dela via


Get-AzPolicyState

Hämtar principefterlevnadstillstånd för resurser.

Syntax

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

Description

Hämtar principefterlevnadstillstånd för resurser. Principtillståndsposter kan efterfrågas i olika omfång. Baserat på det angivna tidsintervallet (standardvärdet för den senaste dagen) kan antingen de senaste principtillstånden eller alla principtillståndsövergångar efterfrågas. Resultat kan filtreras, grupperas och gruppaggregeringar kan beräknas.

Exempel

Exempel 1: Hämta de senaste principtillstånden i det aktuella prenumerationsomfånget

Get-AzPolicyState

Hämtar de senaste principtillståndsposterna som genererades under den senaste dagen för alla resurser i prenumerationen i den aktuella sessionskontexten.

Exempel 2: Hämta de senaste principtillstånden i det angivna prenumerationsomfånget

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

Hämtar de senaste principtillståndsposterna som genererades under den senaste dagen för alla resurser i den angivna prenumerationen.

Exempel 3: Hämta alla principtillstånd i aktuellt prenumerationsomfång

Get-AzPolicyState -All

Hämtar alla historiska principtillståndsposter (inklusive senaste) som genererats under den senaste dagen för alla resurser i prenumerationen i den aktuella sessionskontexten.

Exempel 4: Hämta de senaste principtillstånden i hanteringsgruppens omfång

Get-AzPolicyState -ManagementGroupName "myManagementGroup"

Hämtar de senaste principtillståndsposterna som genererades under den senaste dagen för alla resurser i den angivna hanteringsgruppen.

Exempel 5: Hämta de senaste principtillstånden i resursgruppsomfånget i den aktuella prenumerationen

Get-AzPolicyState -ResourceGroupName "myResourceGroup"

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

Exempel 6: Hämta de senaste principtillstånden i resursgruppsomfånget i den angivna prenumerationen

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

Hämtar de senaste principtillståndsposterna som genererades under den senaste dagen för alla resurser i den angivna resursgruppen (i den angivna prenumerationen).

Exempel 7: Hämta de senaste principtillstånden för en resurs

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

Hämtar de senaste principtillståndsposterna som genererades under den senaste dagen för den angivna resursen.

Exempel 8: Hämta de senaste principtillstånden för en principuppsättningsdefinition i den aktuella prenumerationen

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

Hämtar de senaste principtillståndsposterna 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 9: Hämta de senaste principtillstånden för en principuppsättningsdefinition i den angivna prenumerationen

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

Hämtar de senaste principtillståndsposterna 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 10: Hämta de senaste principtillstånden för en principdefinition i den aktuella prenumerationen

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

Hämtar de senaste principtillståndsposterna 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 11: Hämta de senaste principtillstånden för en principdefinition i den angivna prenumerationen

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

Hämtar de senaste principtillståndsposterna 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 12: Hämta de senaste principtillstånden för en principtilldelning i den aktuella prenumerationen

Get-AzPolicyState -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"

Hämtar de senaste principtillståndsposterna 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 prenumerationsomfånget i prenumerationen i den aktuella sessionskontexten).

Exempel 13: Hämta de senaste principtillstånden för en principtilldelning med samma omfång som den angivna prenumerationen

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

Hämtar de senaste principtillståndsposterna 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 prenumerationsomfånget i den angivna prenumerationen).

Exempel 14: Hämta de senaste principtillstånden för en principtilldelning i den angivna resursgruppen i den aktuella prenumerationen

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

Hämtar de senaste principtillståndsposterna 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 resursgruppen i prenumerationen i den aktuella sessionskontexten).

Exempel 15: Hämta de senaste principtillstånden i det aktuella prenumerationsomfånget med frågealternativen OrderBy, Top och Select

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

Hämtar de senaste principtillståndsposterna som genererades under den senaste dagen för alla resurser i prenumerationen i den aktuella sessionskontexten. Kommandot beställer resultatet efter egenskaper för tidsstämpel och principtilldelningsnamn och tar endast de 5 främsta i den ordningen. Den väljer också att endast visa en delmängd av kolumnerna för varje post.

Exempel 16: Hämta de senaste principtillstånden i det aktuella prenumerationsomfånget med frågealternativen Från och Till

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

Hämtar de senaste principtillståndsposterna som genererats inom det datumintervall som angetts för alla resurser i prenumerationen i den aktuella sessionskontexten.

Exempel 17: Hämta de senaste principtillstånden i det aktuella prenumerationsomfånget med alternativet Filterfrågefråga

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

Hämtar de senaste principtillståndsposterna 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), efterlevnadsstatus (innehåller endast status som inte är kompatibel) och resursplats (exkluderar platsen eastus).

Exempel 18: Hämta de senaste principtillstånden i det aktuella prenumerationsomfånget med Tillämpa som anger aggregering av antal rader

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

Hämtar antalet senaste principtillståndsposter som genererades under den senaste dagen för alla resurser i prenumerationen i den aktuella sessionskontexten. Kommandot returnerar endast antalet principtillståndsposter, som returneras i egenskapen AdditionalProperties.

Exempel 19: Hämta de senaste principtillstånden i det aktuella prenumerationsomfånget, med Använd som anger gruppering med aggregering

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

Hämtar de senaste principtillståndsposterna 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å efterlevnadsstatus (innehåller endast status som inte är kompatibel). Den grupperar resultaten baserat på principtilldelning, principuppsättningsdefinition och principdefinition och beräknar antalet poster i varje grupp, som returneras i egenskapen AdditionalProperties. Resultatet sorteras efter antalet aggregeringar i fallande ordning och tar endast de 5 främsta i den ordningen.

Exempel 20: Hämta de senaste principtillstånden i det aktuella prenumerationsomfånget med Tillämpa som anger gruppering utan aggregering

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

Hämtar de senaste principtillståndsposterna 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å efterlevnadsstatus (innehåller endast status som inte är kompatibel). Resultatet grupperas baserat på resurs-ID. Detta genererar en lista över alla resurser i prenumerationen som inte är kompatibla för minst en princip.

Exempel 21: Hämta de senaste principtillstånden i det aktuella prenumerationsomfånget med Använd som anger flera grupper

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

Hämtar de senaste principtillståndsposterna 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å efterlevnadsstatus (innehåller endast status som inte är kompatibel). Resultatet grupperas först baserat på principtilldelning, principuppsättningsdefinition, principdefinition och resurs-ID. Sedan grupperar den ytterligare resultatet av den här gruppering med samma egenskaper förutom resurs-ID och beräknar antalet poster i var och en av dessa grupper, som returneras i egenskapen AdditionalProperties. Resultatet sorteras efter antalet aggregeringar i fallande ordning och tar endast de 5 främsta i den ordningen. Detta genererar de 5 viktigaste principerna med flest icke-kompatibla resurser.

Exempel 22: Hämta de senaste principtillstånden, inklusive information om principutvärdering för en resurs

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

Hämtar de senaste principtillståndsposterna som genererades under den senaste dagen för den angivna resursen och expanderar policyEvaluationDetails.

Exempel 23: Hämta de senaste komponentprinciptillstånden för en resurs (t.ex. valv) med tanke på en principtilldelning för resursproviderläge

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')"

Hämtar de senaste komponentprinciptillståndsposterna som genererades under den senaste dagen för den angivna resursen, med tanke på en principtilldelning i resursproviderläge som refererar till en principdefinition för resursproviderläge.

Exempel 24: Hämta de senaste komponentprinciptillstånden för en resurs (t.ex. valv) med en principinitiativtilldelning som innehåller en principdefinition för resursproviderläge

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')"

Hämtar de senaste komponentprinciptillståndsposterna som genererades under den senaste dagen för den angivna resursen, givet en principtilldelning i resursproviderläge som refererar till ett initiativ som innehåller en principdefinition för resursproviderläge.

Exempel 25: Hämta de senaste komponentantalen efter efterlevnadstillstånd för en resurs (t.ex. valv) med tanke på en principtilldelning för resursproviderläge

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)))"

Hämtar de senaste komponentantalen som genererades under den senaste dagen grupperade efter efterlevnadstillstånd för den angivna resursen, givet en principtilldelning i resursproviderläge.

Exempel 26: Hämta principtillstånd för en principtilldelning för hanteringsgruppsomfång

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

Hämtar de senaste principtillståndsposterna som genererades under den senaste dagen för alla resurser (inom klientorganisationen i den aktuella sessionskontexten) i den angivna prenumerationen som påverkas av den angivna principtilldelningen (som är tilldelad till en hanteringsgrupp som är en överordnad till den angivna prenumerationen).

Parametrar

-All

Inom det angivna tidsintervallet hämtar du alla principtillstånd i stället för endast den senaste.

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

-Apply

Använd uttryck för aggregeringar med OData-notation.

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

-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

-Expand

Expandera uttryck med OData-notation.

Typ:String
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

-OrderBy

Orderuttryck med OData-notation. Ett eller flera kommaavgränsade kolumnnamn med ett valfritt "desc" (standard) eller "asc".

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

-PolicyAssignmentName

Namnet på en principtilldelning. Den här principtilldelningen måste ha exakt samma omfång som parameteruppsättningen. Det kan inte vara en principtilldelning för hanteringsgruppsomfång. Exempel: om -SubscriptionId och ResourceGroupName anges måste principtilldelningen tilldelas till resursgruppen. Om endast -SubscriptionId anges måste principtilldelningen tilldelas till den prenumerationen.

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

-PolicyDefinitionName

Namnet på en principdefinition. Den här principdefinitionen måste finnas i prenumerationen som efterfrågas. Det kan inte vara en principdefinition för hanteringsgruppsomfång.

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

-PolicySetDefinitionName

Namnet på en principuppsättningsdefinition. Den här principuppsättningsdefinitionen måste finnas i den prenumeration som efterfrågas. Det kan inte vara en principuppsättningsdefinition för hanteringsgruppsomfång.

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

-Select

Välj uttryck med OData-notation. Ett eller flera kommaavgränsade kolumnnamn. Begränsar kolumnerna för varje post till bara de som begärs.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
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

PolicyState