Partager via

Get-AzPolicyStateSummary

  • Référence
Module:
Az.PolicyInsights

Obtient le résumé des états de conformité de stratégie les plus récents pour les ressources.

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

Obtient une vue récapitulative des derniers numéros d’état de conformité des stratégies dans différentes étendues, répartie en attributions de stratégie et définitions de stratégie. Elle inclut uniquement les états de stratégie non conformes.

Exemples

Exemple 1 : Obtenir le dernier résumé des états de stratégie non conformes dans l’étendue actuelle de l’abonnement

Get-AzPolicyStateSummary

Obtient la vue récapitulative des états de conformité de stratégie les plus récents générés le dernier jour pour toutes les ressources de l’abonnement dans le contexte de session actuel.

Exemple 2 : Obtenir le dernier résumé des états de stratégie non conformes dans l’étendue de l’abonnement spécifiée

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

Obtient la vue récapitulative des derniers états de conformité de stratégie générés le dernier jour pour toutes les ressources de l’abonnement spécifié.

Exemple 3 : Obtenir le résumé des états de stratégie non conformes les plus récents dans l’étendue du groupe d’administration

Get-AzPolicyStateSummary -ManagementGroupName "myManagementGroup"

Obtient la vue récapitulative des états de conformité de stratégie les plus récents générés le dernier jour pour toutes les ressources du groupe d’administration spécifié.

Exemple 4 : Obtenir le résumé des états de stratégie non conformes les plus récents dans l’étendue du groupe de ressources dans l’abonnement actuel

Get-AzPolicyStateSummary -ResourceGroupName "myResourceGroup"

Obtient la vue récapitulative des derniers états de conformité de stratégie générés le dernier jour pour toutes les ressources du groupe de ressources spécifié (dans l’abonnement dans le contexte de session actuel).

Exemple 5 : Obtenir le résumé des états de stratégie non conformes les plus récents dans l’étendue du groupe de ressources dans l’abonnement spécifié

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

Obtient la vue récapitulative des états de conformité de stratégie les plus récents générés le dernier jour pour toutes les ressources du groupe de ressources spécifié (dans l’abonnement spécifié).

Exemple 6 : Obtenir le dernier résumé des états de stratégie non conformes pour une ressource

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

Obtient la vue récapitulative des derniers états de conformité de stratégie générés le dernier jour pour la ressource spécifiée.

Exemple 7 : Obtenir le dernier résumé des états de stratégie non conformes pour une définition d’ensemble de stratégies dans l’abonnement actuel

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

Obtient la vue récapitulative des états de conformité de stratégie les plus récents générés le dernier jour pour toutes les ressources (dans le locataire dans le contexte de session actuel) effectuée par la définition de jeu de stratégies spécifiée (qui existe dans l’abonnement dans le contexte de session actuelle).

Exemple 8 : Obtenir le dernier résumé des états de stratégie non conformes pour une définition de jeu de stratégies dans l’abonnement spécifié

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

Obtient la vue récapitulative des états de conformité de stratégie les plus récents générés le dernier jour pour toutes les ressources (dans le client dans le contexte de session actuel) effectuée par la définition de jeu de stratégies spécifiée (qui existe dans l’abonnement spécifié).

Exemple 9 : Obtenir le dernier résumé des états de stratégie non conformes pour une définition de stratégie dans l’abonnement actuel

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

Obtient la vue récapitulative des états de conformité de stratégie les plus récents générés le dernier jour pour toutes les ressources (dans le client dans le contexte de session actuel) effectuée par la définition de stratégie spécifiée (qui existe dans l’abonnement dans le contexte de session actuelle).

Exemple 10 : Obtenir le dernier résumé des états de stratégie non conformes pour une définition de stratégie dans l’abonnement spécifié

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

Obtient la vue récapitulative des états de conformité de stratégie les plus récents générés le dernier jour pour toutes les ressources (dans le client dans le contexte de session actuel) effectuée par la définition de stratégie spécifiée (qui existe dans l’abonnement spécifié).

Exemple 11 : Obtenir le dernier résumé des états de stratégie non conformes pour une attribution de stratégie dans l’abonnement actuel

Get-AzPolicyStateSummary -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"

Obtient la vue récapitulative des états de conformité de stratégie les plus récents générés le dernier jour pour toutes les ressources (dans le locataire dans le contexte de session en cours) effectuées par l’attribution de stratégie spécifiée (qui existe dans l’abonnement dans le contexte de session en cours).

Exemple 12 : Obtenir le dernier résumé des états de stratégie non conformes pour une attribution de stratégie dans l’abonnement spécifié

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

Obtient la vue récapitulative des derniers états de conformité de stratégie générés le dernier jour pour toutes les ressources (dans le client dans le contexte de session actuel) effectuée par l’attribution de stratégie spécifiée (qui existe dans l’abonnement spécifié).

Exemple 13 : Obtenir le dernier résumé des états de stratégie non conformes pour une attribution de stratégie dans le groupe de ressources spécifié dans l’abonnement actuel

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

Obtient la vue récapitulative des états de conformité de stratégie les plus récents générés le dernier jour pour toutes les ressources (dans le client dans le contexte de session en cours) effectuée par l’attribution de stratégie spécifiée (qui existe dans le groupe de ressources de l’abonnement dans le contexte de session actuel).

Exemple 14 : Obtenir le dernier résumé des états de stratégie non conformes dans l’étendue actuelle de l’abonnement, avec l’option De requête supérieure

Get-AzPolicyStateSummary -Top 5

Obtient la vue récapitulative des états de conformité de stratégie les plus récents générés le dernier jour pour toutes les ressources de l’abonnement dans le contexte de session actuel. La commande trie les résumés d’affectation de stratégie dans les résultats par nombre de ressources non conformes dans l’ordre décroissant et ne prend que 5 principaux de ces résumés d’affectation de stratégie.

Exemple 15 : Obtenir le dernier résumé des états de stratégie non conformes dans l’étendue actuelle de l’abonnement, avec les options De et À requête

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

Obtient la vue récapitulative des états de conformité de stratégie les plus récents générés dans la plage de dates spécifiée pour toutes les ressources de l’abonnement dans le contexte de session actuel.

Exemple 16 : Obtenir le résumé des états de stratégie non conformes les plus récents dans l’étendue de l’abonnement actuel, avec l’option de requête Filter

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

Obtient la vue récapitulative des états de conformité de stratégie les plus récents générés le dernier jour pour toutes les ressources de l’abonnement dans le contexte de session actuel. La commande limite les résultats retournés en filtrant en fonction de l’action de définition de stratégie (inclut les actions de refus ou d’audit) et l’emplacement des ressources (exclut l’emplacement eastus).

Paramètres

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Filter

Expression de filtre à l’aide de la notation OData.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-From

Horodatage mis en forme ISO 8601 spécifiant l’heure de début de l’intervalle à interroger. Lorsqu’il n’est pas spécifié, la valeur du paramètre « To » est définie par défaut moins 1 jour.

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ManagementGroupName

Nom du groupe d’administration.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PolicyAssignmentName

Nom de l’attribution de stratégie.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PolicyDefinitionName

Nom de la définition de stratégie.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PolicySetDefinitionName

Nom de définition du jeu de stratégies.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ResourceGroupName

Nom du groupe de ressources.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ResourceId

ID de ressource.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SubscriptionId

ID d’abonnement.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-To

Horodatage mis en forme ISO 8601 spécifiant l’heure de fin de l’intervalle à interroger. Lorsqu’il n’est pas spécifié, la valeur par défaut est la durée de la requête.

Type:DateTime
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Top

Nombre maximal d’enregistrements à retourner.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

Sorties

PolicyStateSummary