Compartilhar via


Get-UsageAggregates

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

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

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

Description

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

  • Horários de início e término de quando o uso foi relatado.
  • Precisão de agregação, diária ou horária.
  • Detalhes no nível da 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/1ea5b323-54bb-423d-916f-190de96c6a3c da API REST de Cobrança do Azure (https://msdn.microsoft.com/library/azure/1ea5b323-54bb-423d-916f-190de96c6a3c) na biblioteca do Microsoft Developer Network.

Exemplos

Exemplo 1: recuperar dados de assinatura

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

Esse comando recupera os dados de uso relatados para a assinatura entre 02/05/2015 e 05/05/2015.

Parâmetros

-AggregationGranularity

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

Tipo:Microsoft.Azure.Commerce.UsageAggregates.Models.AggregationGranularity
Valores aceitos:Daily, Hourly
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ContinuationToken

Especifica o token de continuação que foi recuperado do corpo da resposta na chamada anterior. Para um conjunto de resultados grande, 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 hora especificados em ReportedStartTime. Recomendamos que você siga o próximo link na página de resposta para os dados.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ReportedEndTime

Especifica a hora de término relatada para quando o uso de recursos 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 o momento em que 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 pelo uso do recurso. Para obter todos os eventos de uso de uma assinatura relatados por um período de tempo, consulte por hora relatada. Mesmo que você consulte por hora relatada, o cmdlet agrega os dados de resposta pelo tempo de uso do recurso. Os dados de uso de recursos são o pivô útil para analisar os dados.

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ReportedStartTime

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

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ShowDetails

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 agregará os resultados no lado do servidor e, portanto, retornará menos grupos agregados. Por exemplo, se você estiver executando três sites, por padrão, receberá três itens de linha para consumo do site. 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.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

Microsoft.Azure.Commerce.UsageAggregates.Models.UsageAggregationGetResponse