Share via

Get-AzPolicyStateSummary

  • Referencia
Módulo:
Az.PolicyInsights

Obtiene el resumen de los estados de cumplimiento de directivas más recientes para los recursos.

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

Obtiene una vista de resumen de los números de estado de cumplimiento de directivas más recientes en varios ámbitos, desglosados en asignaciones de directivas y definiciones de directiva. Solo incluye estados de directiva no compatibles.

Ejemplos

Ejemplo 1: Obtener el resumen de los estados de directiva no compatibles más recientes en el ámbito de la suscripción actual

Get-AzPolicyStateSummary

Obtiene la vista de resumen de los estados de cumplimiento de directivas más recientes generados en el último día para todos los recursos de la suscripción en el contexto de sesión actual.

Ejemplo 2: Obtener el resumen de los estados de directiva no compatibles más recientes en el ámbito de suscripción especificado

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

Obtiene la vista de resumen de los estados de cumplimiento de directivas más recientes generados en el último día para todos los recursos de la suscripción especificada.

Ejemplo 3: Obtener el resumen de los estados de directiva no compatibles más recientes en el ámbito del grupo de administración

Get-AzPolicyStateSummary -ManagementGroupName "myManagementGroup"

Obtiene la vista de resumen de los estados de cumplimiento de directivas más recientes generados en el último día para todos los recursos del grupo de administración especificado.

Ejemplo 4: Obtener el resumen de los estados de directiva no compatibles más recientes en el ámbito del grupo de recursos en la suscripción actual

Get-AzPolicyStateSummary -ResourceGroupName "myResourceGroup"

Obtiene la vista de resumen de los estados de cumplimiento de directivas más recientes generados en el último día para todos los recursos del grupo de recursos especificado (en la suscripción en el contexto de sesión actual).

Ejemplo 5: Obtener el resumen de estados de directiva no compatibles más recientes en el ámbito del grupo de recursos en la suscripción especificada

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

Obtiene la vista de resumen de los estados de cumplimiento de directivas más recientes generados en el último día para todos los recursos del grupo de recursos especificado (en la suscripción especificada).

Ejemplo 6: Obtener el resumen de estados de directiva no compatibles más recientes para un recurso

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

Obtiene la vista de resumen de los estados de cumplimiento de directivas más recientes generados en el último día para el recurso especificado.

Ejemplo 7: Obtener el resumen de estados de directiva no compatibles más recientes para una definición de conjunto de directivas en la suscripción actual

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

Obtiene la vista de resumen de los estados de cumplimiento de directivas más recientes generados en el último día para todos los recursos (dentro del inquilino en el contexto de sesión actual) que afecta la definición del conjunto de directivas especificado (que existe en la suscripción en el contexto de sesión actual).

Ejemplo 8: Obtener el resumen de estados de directiva no compatibles más recientes para una definición de conjunto de directivas en la suscripción especificada

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

Obtiene la vista de resumen de los estados de cumplimiento de directivas más recientes generados en el último día para todos los recursos (dentro del inquilino en el contexto de sesión actual) afectados por la definición de conjunto de directivas especificada (que existe en la suscripción especificada).

Ejemplo 9: Obtener el resumen de estados de directiva no compatibles más recientes para una definición de directiva en la suscripción actual

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

Obtiene la vista de resumen de los estados de cumplimiento de directivas más recientes generados en el último día para todos los recursos (dentro del inquilino en el contexto de sesión actual) que afecta la definición de directiva especificada (que existe en la suscripción en el contexto de sesión actual).

Ejemplo 10: Obtener el resumen de estados de directiva no compatibles más recientes para una definición de directiva en la suscripción especificada

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

Obtiene la vista de resumen de los estados de cumplimiento de directivas más recientes generados en el último día para todos los recursos (dentro del inquilino en el contexto de sesión actual) que afecta la definición de directiva especificada (que existe en la suscripción especificada).

Ejemplo 11: Obtener el resumen de los estados de directiva no compatibles más recientes para una asignación de directiva en la suscripción actual

Get-AzPolicyStateSummary -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"

Obtiene la vista de resumen de los estados de cumplimiento de directivas más recientes generados en el último día para todos los recursos (dentro del inquilino en el contexto de sesión actual) que afecta la asignación de directiva especificada (que existe en la suscripción en el contexto de sesión actual).

Ejemplo 12: Obtener el resumen de los estados de directiva no compatibles más recientes para una asignación de directiva en la suscripción especificada

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

Obtiene la vista de resumen de los estados de cumplimiento de directivas más recientes generados en el último día para todos los recursos (dentro del inquilino en el contexto de sesión actual) que afecta la asignación de directiva especificada (que existe en la suscripción especificada).

Ejemplo 13: Obtener el resumen de estados de directiva no compatibles más recientes para una asignación de directiva en el grupo de recursos especificado en la suscripción actual

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

Obtiene la vista de resumen de los estados de cumplimiento de directivas más recientes generados en el último día para todos los recursos (dentro del inquilino en el contexto de sesión actual) que afecta la asignación de directiva especificada (que existe en el grupo de recursos de la suscripción en el contexto de sesión actual).

Ejemplo 14: Obtener el resumen de estados de directiva no conformes más recientes en el ámbito de la suscripción actual, con la opción De consulta superior

Get-AzPolicyStateSummary -Top 5

Obtiene la vista de resumen de los estados de cumplimiento de directivas más recientes generados en el último día para todos los recursos de la suscripción en el contexto de sesión actual. El comando ordena los resúmenes de asignación de directivas en los resultados por recuentos de recursos no compatibles en orden descendente y solo toma los 5 primeros resúmenes de asignación de directiva.

Ejemplo 15: Obtener el resumen de los estados de directiva no compatibles más recientes en el ámbito de la suscripción actual, con opciones de consulta Desde y To

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

Obtiene la vista de resumen de los estados de cumplimiento de directivas más recientes generados dentro del intervalo de fechas especificado para todos los recursos de la suscripción en el contexto de sesión actual.

Ejemplo 16: Obtener el resumen de los estados de directiva no compatibles más recientes en el ámbito de la suscripción actual, con la opción Filtrar consulta

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

Obtiene la vista de resumen de los estados de cumplimiento de directivas más recientes generados en el último día para todos los recursos de la suscripción en el contexto de sesión actual. El comando limita los resultados devueltos filtrando en función de la acción de definición de directiva (incluye acciones de denegación o auditoría) y ubicación del recurso (excluye la ubicación eastus).

Parámetros

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Filter

Filtrar expresión mediante notación OData.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-From

Marca de tiempo con formato ISO 8601 que especifica la hora de inicio del intervalo que se va a consultar. Cuando no se especifica, el valor predeterminado del parámetro "To" es menos 1 día.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ManagementGroupName

Nombre del grupo de administración.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PolicyAssignmentName

Nombre de asignación de directiva.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PolicyDefinitionName

Nombre de definición de directiva.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PolicySetDefinitionName

Nombre de definición del conjunto de directivas.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Nombre del grupo de recursos.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

Identificador del recurso.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SubscriptionId

Id. de suscripción.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-To

Marca de tiempo con formato ISO 8601 que especifica la hora de finalización del intervalo que se va a consultar. Cuando no se especifica, el valor predeterminado es la hora de la solicitud.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Top

Número máximo de registros que se van a devolver.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Salidas

PolicyStateSummary