Get-O365ClientOSReport

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Online

Esse cmdlet só está disponível no serviço baseado em nuvem.

Este cmdlet foi substituído em janeiro de 2018. Para saber mais sobre os relatórios do Microsoft Graph disponíveis para substituição no Microsoft 365, confira os sub-tópicos de Trabalhando com relatórios de uso do Microsoft 365 no Microsoft Graph.

Use o cmdlet Get-O365ClientOSReport para obter um relatório de resumo do uso do sistema operacional cliente.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Get-O365ClientOSReport
   [-EndDate <DateTime>]
   [-OS <String>]
   [-ResultSize <Unlimited>]
   [-StartDate <DateTime>]
   [<CommonParameters>]

Description

O relatório exibe as estatísticas de uso do cliente para as cinco versões mais recentes dos sistemas operacionais nomeados na descrição do parâmetro do sistema operacional. Todas as versões anteriores do sistema operacional são combinadas em uma sexta categoria chamada Outros. A lista a seguir descreve as propriedades que são retornadas nos resultados.

  • TenantGuid: identificador exclusivo do locatário.
  • TenantName: Nome do locatário.
  • Data: última vez que os dados do item de linha foram agregados.
  • OperatingSystem: nome do sistema operacional.
  • Versão: versão do sistema operacional.
  • OperatingSystemUsageCount: número de vezes uma determinada combinação de sistema operacional e versão conectada ao serviço durante o período de relatório.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Get-O365ClientOSReport -OS Windows

Este exemplo obtém o relatório de resumo do uso do Windows do cliente para o período de retenção de dados de 366 dias (nenhuma data de início e término é especificada).

Exemplo 2

Get-O365ClientOSReport -StartDate 06/13/2014 -EndDate 06/15/2014

Este exemplo recupera as informações do sistema operacional cliente entre 13 de junho de 2014 e 15 de junho de 2014.

Parâmetros

-EndDate

O parâmetro EndDate especifica a data de término do intervalo de datas.

Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada mm/dd/yyyy, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/2018 17:00".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-OS

O parâmetro OS filtra o relatório por sistema operacional. Se você não usar esse parâmetro, todos os sistemas operacionais serão incluídos. Os valores aceitos para esse parâmetro são:

  • Windows
  • Android
  • iOS
  • "Mac OS"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ResultSize

O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Caso pretenda retornar todas as solicitações correspondentes à consulta, use unlimited como valor desse parâmetro. O valor padrão é 1000.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-StartDate

O parâmetro StartDate especifica a data de início do intervalo de datas.

Use o formato de data curto definido nas configurações de opções regionais no computador no qual você está executando o comando. Por exemplo, se o computador estiver configurado para usar o formato de data abreviada mm/dd/yyyy, insira 01/09/2018 para especificar 1º de setembro de 2018. Pode inserir apenas a data ou pode inserir a data e a hora do dia. Se você inserir a data e a hora do dia, coloque o valor entre aspas ("), por exemplo, "01/09/2018 17:00".

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online