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-AzPolicyStateHä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 -AllHä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 5Hä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 5Hä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 |