Get-AzPolicyStateSummary
Získá nejnovější souhrn stavů dodržování předpisů zásad pro prostředky.
Syntaxe
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
Získá souhrnné zobrazení nejnovějších čísel stavu dodržování zásad v různých oborech, rozdělené na přiřazení zásad a definice zásad. Zahrnuje pouze nekompatibilní stavy zásad.
Příklady
Příklad 1: Získání nejnovějšího souhrnu stavů nedodržující předpisy v aktuálním rozsahu předplatného
Get-AzPolicyStateSummaryZíská souhrnné zobrazení nejnovějších stavů dodržování předpisů zásad vygenerovaných za poslední den pro všechny prostředky v rámci předplatného v aktuálním kontextu relace.
Příklad 2: Získání nejnovějšího souhrnu stavů nedodržující předpisy v zadaném oboru předplatného
Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5"Získá souhrnné zobrazení nejnovějších stavů dodržování předpisů zásad vygenerovaných za poslední den pro všechny prostředky v rámci zadaného předplatného.
Příklad 3: Získání nejnovějšího souhrnu stavů nedodržující předpisy v oboru skupiny pro správu
Get-AzPolicyStateSummary -ManagementGroupName "myManagementGroup"Získá souhrnné zobrazení nejnovějších stavů dodržování předpisů zásad vygenerovaných v posledním dni pro všechny prostředky v zadané skupině pro správu.
Příklad 4: Získání nejnovějšího souhrnu stavů nedodržující předpisy v oboru skupiny prostředků v aktuálním předplatném
Get-AzPolicyStateSummary -ResourceGroupName "myResourceGroup"Získá souhrnné zobrazení nejnovějších stavů dodržování předpisů zásad vygenerovaných v posledním dni pro všechny prostředky v rámci zadané skupiny prostředků (v předplatném v aktuálním kontextu relace).
Příklad 5: Získání nejnovějšího souhrnu stavů nedodržující předpisy v oboru skupiny prostředků v zadaném předplatném
Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -ResourceGroupName "myResourceGroup"Získá souhrnné zobrazení nejnovějších stavů dodržování předpisů zásad vygenerovaných v posledním dni pro všechny prostředky v zadané skupině prostředků (v zadaném předplatném).
Příklad 6: Získání nejnovějšího souhrnu stavů nedodržující předpisy pro prostředek
Get-AzPolicyStateSummary -ResourceId "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myResourceGroup/providers/Microsoft.EventHub/namespaces/myns1/eventhubs/eh1/consumergroups/cg1"Získá souhrnné zobrazení nejnovějších stavů dodržování předpisů zásad vygenerovaných za poslední den pro zadaný prostředek.
Příklad 7: Získání nejnovějšího souhrnu stavů nevyhovujících zásad pro definici sady zásad v aktuálním předplatném
Get-AzPolicyStateSummary -PolicySetDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"Získá souhrnné zobrazení nejnovějších stavů dodržování předpisů zásad vygenerovaných za poslední den pro všechny prostředky (v rámci tenanta v kontextu aktuální relace) ovlivněné definicí zadané sady zásad (která existuje v předplatném v aktuálním kontextu relace).
Příklad 8: Získání nejnovějšího souhrnu stavů nevyhovujících zásad pro definici sady zásad v zadaném předplatném
Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -PolicySetDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"Získá souhrnné zobrazení nejnovějších stavů dodržování zásad vygenerovaných za poslední den pro všechny prostředky (v rámci tenanta v kontextu aktuální relace) ovlivněné zadanou definicí sady zásad (která existuje v zadaném předplatném).
Příklad 9: Získání nejnovějšího souhrnu stavů nedodržující předpisy pro definici zásad v aktuálním předplatném
Get-AzPolicyStateSummary -PolicyDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"Získá souhrnné zobrazení nejnovějších stavů dodržování zásad vygenerovaných v posledním dni pro všechny prostředky (v rámci tenanta v kontextu aktuální relace) ovlivněné zadanou definicí zásad (která existuje v předplatném v aktuálním kontextu relace).
Příklad 10: Získání nejnovějšího souhrnu stavů nekompatibilních zásad pro definici zásady v zadaném předplatném
Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -PolicyDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"Získá souhrnné zobrazení nejnovějších stavů dodržování zásad vygenerovaných v posledním dni pro všechny prostředky (v rámci tenanta v kontextu aktuální relace) ovlivněné zadanou definicí zásady (která existuje v zadaném předplatném).
Příklad 11: Získání nejnovějšího souhrnu stavů nedodržující předpisy pro přiřazení zásad v aktuálním předplatném
Get-AzPolicyStateSummary -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"Získá souhrnné zobrazení nejnovějších stavů dodržování předpisů zásad vygenerovaných za poslední den pro všechny prostředky (v rámci tenanta v kontextu aktuální relace) ovlivněné zadaným přiřazením zásad (které existuje v předplatném v aktuálním kontextu relace).
Příklad 12: Získání nejnovějšího souhrnu stavů nedodržující předpisy pro přiřazení zásad v zadaném předplatném
Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"Získá souhrnné zobrazení nejnovějších stavů dodržování předpisů zásad vygenerovaných za poslední den pro všechny prostředky (v rámci tenanta v aktuálním kontextu relace) ovlivněné zadaným přiřazením zásad (které existuje v zadaném předplatném).
Příklad 13: Získání nejnovějšího souhrnu stavů nedodržující předpisy pro přiřazení zásad v zadané skupině prostředků v aktuálním předplatném
Get-AzPolicyStateSummary -ResourceGroupName "myResourceGroup" -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"Získá souhrnné zobrazení nejnovějších stavů dodržování předpisů zásad vygenerovaných za poslední den pro všechny prostředky (v rámci tenanta v kontextu aktuální relace) ovlivněné zadaným přiřazením zásad (které existuje ve skupině prostředků v předplatném v aktuálním kontextu relace).
Příklad 14: Získání nejnovějšího souhrnu stavů nedodržující předpisy v aktuálním rozsahu předplatného s možností Nejčastější dotaz
Get-AzPolicyStateSummary -Top 5Získá souhrnné zobrazení nejnovějších stavů dodržování předpisů zásad vygenerovaných za poslední den pro všechny prostředky v rámci předplatného v aktuálním kontextu relace. Příkaz objedná souhrny přiřazení zásad ve výsledcích podle počtu prostředků nedodržujících předpisy v sestupném pořadí a vezme pouze prvních 5 souhrnů přiřazení zásad.
Příklad 15: Získání nejnovějšího souhrnu stavů nedodržující předpisy v aktuálním rozsahu předplatného s možnostmi dotazu Od a Do
Get-AzPolicyStateSummary -From "2018-03-08 00:00:00Z" -To "2018-03-15 00:00:00Z"Získá souhrnné zobrazení nejnovějších stavů dodržování zásad vygenerovaných v rozsahu kalendářních dat určených pro všechny prostředky v rámci předplatného v aktuálním kontextu relace.
Příklad 16: Získání nejnovějšího souhrnu stavů nedodržující předpisy v aktuálním rozsahu předplatného s možností dotaz filtru
Get-AzPolicyStateSummary -Filter "(PolicyDefinitionAction eq 'deny' or PolicyDefinitionAction eq 'audit') and ResourceLocation ne 'eastus'"Získá souhrnné zobrazení nejnovějších stavů dodržování předpisů zásad vygenerovaných za poslední den pro všechny prostředky v rámci předplatného v aktuálním kontextu relace. Příkaz omezuje výsledky vrácené filtrováním na základě akce definice zásady (včetně akcí odepření nebo auditování) a umístění prostředků (vylučuje umístění eastus).
Parametry
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
| Typ: | IAzureContextContainer |
| Aliasy: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Filter
Filtrovací výraz pomocí notace OData
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-From
Časové razítko ve formátu ISO 8601 určující počáteční čas intervalu pro dotaz. Pokud není zadáno, použije se výchozí hodnota parametru To minus 1 den.
| Typ: | DateTime |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ManagementGroupName
Název skupiny pro správu
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-PolicyAssignmentName
Název přiřazení zásad
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-PolicyDefinitionName
Název definice zásady.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-PolicySetDefinitionName
Název definice sady zásad
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-ResourceGroupName
Název skupiny prostředků.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-ResourceId
ID prostředku.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-SubscriptionId
ID předplatného
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-To
Časové razítko ve formátu ISO 8601 určující koncový čas intervalu, který se má dotazovat. Pokud ho nezadáte, použije se výchozí hodnota pro čas požadavku.
| Typ: | DateTime |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Top
Maximální počet záznamů, které se mají vrátit.
| Typ: | Int32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
Vstupy
Výstupy
Související odkazy
Azure PowerShell