Partilhar via

Get-AzUsageAggregate

Módulo:
Az.Billing Module

Obtém os detalhes de uso da assinatura do Azure relatados.

Sintaxe

Default (Padrão) 

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

Descrição

O cmdlet Get-AzUsageAggregate obtém dados agregados de uso da assinatura do Azure pelas seguintes propriedades:

  • Horários de início e fim de quando o uso foi relatado.
  • Precisão de agregação, diária ou horária.
  • Detalhe em nível de instância para várias instâncias do mesmo recurso. Para obter resultados consistentes, os dados retornados são baseados em quando os detalhes de uso foram relatados pelo recurso do Azure. Para obter mais informações, consulte Referênciahttps://msdn.microsoft.com/library/azure/aaaabbbb-0000-cccc-1111-dddd2222eeee da API REST de Cobrança do Azure (https://msdn.microsoft.com/library/azure/aaaabbbb-0000-cccc-1111-dddd2222eeee) na biblioteca do Microsoft Developer Network.

Exemplos

Exemplo 1: Recuperar dados de subscrição

Get-AzUsageAggregate -ReportedStartTime "5/2/2015" -ReportedEndTime "5/5/2015"

Este comando recupera os dados de uso relatados para a assinatura entre 5/2/2015 e 5/5/2015.

Parâmetros

-AggregationGranularity

Especifica a precisão de agregação dos dados. Os valores válidos são: Diário e Horista. O valor padrão é Daily.

Propriedades dos parâmetros

Tipo:Microsoft.Azure.Commerce.UsageAggregates.Models.AggregationGranularity
Valor padrão:None
Valores aceites:Daily, Hourly
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-ContinuationToken

Especifica o token de continuação que foi recuperado do corpo da resposta na chamada anterior. Para um grande conjunto de resultados, as respostas são paginadas usando tokens de continuação. O token de continuação serve como um marcador para o progresso. Se você não especificar esse parâmetro, os dados serão recuperados do início do dia ou da hora especificados em ReportedStartTime. Recomendamos que você siga o próximo link na página de resposta aos dados.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-ReportedEndTime

Especifica a hora de término relatada para quando o uso do recurso foi registrado no sistema de cobrança do Azure. O Azure é um sistema distribuído, abrangendo vários datacenters em todo o mundo, portanto, há um atraso entre quando o recurso foi realmente consumido, que é o tempo de uso do recurso, e quando o evento de uso atingiu o sistema de cobrança, que é o tempo relatado de uso do recurso. Para obter todos os eventos de uso de uma assinatura que são relatados por um período de tempo, você consulta por hora relatada. Embora você consulte por tempo relatado, o cmdlet agrega os dados de resposta pelo tempo de uso do recurso. Os dados de uso do recurso são o pivô útil para analisar os dados.

Propriedades dos parâmetros

Tipo:DateTime
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-ReportedStartTime

Especifica a hora de início relatada para quando o uso do recurso foi registrado no sistema de cobrança do Azure.

Propriedades dos parâmetros

Tipo:DateTime
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-ShowDetail

Indica se esse cmdlet retorna detalhes no nível da instância com os dados de uso. O valor padrão é $True. Se $False, o serviço agrega os resultados no lado do servidor e, portanto, retorna menos grupos agregados. Por exemplo, se você estiver executando três sites, por padrão, você receberá três itens de linha para consumo de sites. No entanto, quando o valor é $False, todos os dados para o mesmo subscriptionId, meterId, usageStartTime e usageEndTime são recolhidos em um único item de linha.

Propriedades dos parâmetros

Tipo:Boolean
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:MostrarDetalhes

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Saídas

Microsoft.Azure.Commerce.UsageAggregates.Models.UsageAggregationGetResponse