Compartir a través de


Get-UsageAggregates

Obtiene los detalles de uso de la suscripción de Azure notificados.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

Get-UsageAggregates
   -ReportedStartTime <DateTime>
   -ReportedEndTime <DateTime>
   [-AggregationGranularity <AggregationGranularity>]
   [-ShowDetails <Boolean>]
   [-ContinuationToken <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet Get-UsageAggregates obtiene los datos de uso de la suscripción de Azure agregados mediante las siguientes propiedades:

  • Horas de inicio y finalización de cuándo se notificó el uso.
  • Precisión de agregación, ya sea diaria o por hora.
  • Detalle del nivel de instancia para varias instancias del mismo recurso. Para obtener resultados coherentes, los datos devueltos se basan en el momento en que el recurso de Azure notificó los detalles de uso. Para más información, consulte Referenciahttps://msdn.microsoft.com/library/azure/1ea5b323-54bb-423d-916f-190de96c6a3c de la API REST de facturación de Azure (https://msdn.microsoft.com/library/azure/1ea5b323-54bb-423d-916f-190de96c6a3c) en la biblioteca microsoft Developer Network.

Ejemplos

Ejemplo 1: Recuperación de datos de suscripción

PS C:\>Get-UsageAggregates -ReportedStartTime "5/2/2015" -ReportedEndTime "5/5/2015"

Este comando recupera los datos de uso notificados para la suscripción entre el 2/5/5/2015 y el 5/5/2015.

Parámetros

-AggregationGranularity

Especifica la precisión de agregación de los datos. Los valores válidos son: Daily y Hourly. El valor predeterminado es Daily.

Tipo:Microsoft.Azure.Commerce.UsageAggregates.Models.AggregationGranularity
Valores aceptados:Daily, Hourly
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ContinuationToken

Especifica el token de continuación que se recuperó del cuerpo de la respuesta en la llamada anterior. Para un conjunto de resultados grande, las respuestas se paginan mediante tokens de continuación. El token de continuación actúa como marcador para el progreso. Si no especifica este parámetro, los datos se recuperan desde el principio del día o la hora especificados en ReportedStartTime. Se recomienda seguir el vínculo siguiente en la respuesta a la página a través de los datos.

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

-DefaultProfile

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

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

-ReportedEndTime

Especifica la hora de finalización notificada para cuándo se registró el uso de recursos en el sistema de facturación de Azure. Azure es un sistema distribuido, que abarca varios centros de datos de todo el mundo, por lo que hay un retraso entre el momento en que el recurso se consumió realmente, que es el tiempo de uso de recursos y el momento en que el evento de uso alcanzó el sistema de facturación, que es el tiempo notificado del uso de recursos. Para obtener todos los eventos de uso de una suscripción que se notifican durante un período de tiempo, se consulta por hora notificada. Aunque consulte por hora notificada, el cmdlet agrega los datos de respuesta por el tiempo de uso del recurso. Los datos de uso de recursos son la tabla dinámica útil para analizar los datos.

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

-ReportedStartTime

Especifica la hora de inicio notificada para cuándo se registró el uso de recursos en el sistema de facturación de Azure.

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

-ShowDetails

Indica si este cmdlet devuelve detalles de nivel de instancia con los datos de uso. El valor predeterminado es $True. Si $False, el servicio agrega los resultados en el servidor y, por tanto, devuelve menos grupos agregados. Por ejemplo, si ejecuta tres sitios web, de forma predeterminada obtendrá tres elementos de línea para el consumo del sitio web. Sin embargo, cuando el valor es $False, todos los datos del mismo subscriptionId, meterId, usageStartTime y usageEndTime se contraen en un solo elemento de línea.

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

Entradas

None

Salidas

Microsoft.Azure.Commerce.UsageAggregates.Models.UsageAggregationGetResponse