Compartir a través de

Get-AzPolicyStateSummary

  • Referencia
Módulo:
Az.PolicyInsights

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

Sintaxis

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

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Filter

Filtrar expresión mediante notación OData.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ManagementGroupName

Nombre del grupo de administración.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PolicyAssignmentName

Nombre de asignación de directiva.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PolicyDefinitionName

Nombre de definición de directiva.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-PolicySetDefinitionName

Nombre de definición del conjunto de directivas.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ResourceGroupName

Nombre del grupo de recursos.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ResourceId

Identificador de recurso.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SubscriptionId

Id. de suscripción.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Top

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

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

String

Salidas

PolicyStateSummary