Get-MobileDeviceStatistics

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.

Use o cmdlet Get-MobileDeviceStatistics para recuperar a lista de dispositivos móveis configurados para sincronizar com a caixa de correio de um usuário especificado e retornar uma lista de estatísticas sobre os dispositivos móveis.

Observação: em Exchange Online PowerShell, recomendamos que você use o cmdlet Get-EXOMobileDeviceStatistics em vez desse cmdlet. Para saber mais, confira Conectar-se ao Exchange Online usando o PowerShell Remoto.

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

Syntax

Get-MobileDeviceStatistics
   [-Identity] <MobileDeviceIdParameter>
   [-ActiveSync]
   [-DomainController <Fqdn>]
   [-GetMailboxLog]
   [-NotificationEmailAddresses <MultiValuedProperty>]
   [-OWAforDevices]
   [-ShowRecoveryPassword]
   [-RestApi]
   [-UniversalOutlook]
   [<CommonParameters>]
Get-MobileDeviceStatistics
   -Mailbox <MailboxIdParameter>
   [-ActiveSync]
   [-DomainController <Fqdn>]
   [-GetMailboxLog]
   [-NotificationEmailAddresses <MultiValuedProperty>]
   [-OWAforDevices]
   [-ShowRecoveryPassword]
   [-RestApi]
   [-UniversalOutlook]
   [<CommonParameters>]

Description

O cmdlet Get-MobileDeviceStatistics retorna uma lista de estatísticas sobre cada dispositivo móvel. Além disso, ele permite recuperar logs e enviá-los a um destinatário para solucionar problemas.

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-MobileDeviceStatistics -Identity TonySmith\ExchangeActiveSyncDevices\REST§Outlook§5eec4e941e0748a264512fd83770d5ac

Este exemplo recupera as estatísticas do telefone celular especificado.

Exemplo 2

$UserList = Get-CASMailbox -ResultSize unlimited -Filter "HasActiveSyncDevicePartnership -eq `$true -and -not DisplayName -like 'CAS_{*'"

$UserList | foreach {Get-MobileDeviceStatistics -Mailbox $_.Identity}

Este exemplo usa o cmdlet Get-CASMailbox para determinar quem na organização tem um dispositivo móvel Exchange ActiveSync. Para cada dispositivo móvel, as estatísticas do dispositivo Exchange ActiveSync são recuperadas.

Observação: para obter mais informações sobre a sintaxe do filtro OPATH, consulte Informações adicionais de sintaxe OPATH.

Exemplo 3

Get-MobileDeviceStatistics -Mailbox "Tony Smith" -GetMailboxLog -NotificationEmailAddresses "admin@contoso.com"

Este exemplo recupera as estatísticas do celular configurado para sincronizar com a caixa de correio de Tony Smith. Ele também gera o arquivo de log e o envia para o Administrador do Sistema em admin@contoso.com.

Parâmetros

-ActiveSync

A opção ActiveSync filtra os resultados por dispositivos Exchange ActiveSync. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

Este parâmetro está disponível somente no Exchange local.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-GetMailboxLog

A opção GetMailboxLog especifica se deve enviar as estatísticas do dispositivo móvel para os endereços de email especificados pelo parâmetro NotificationEmailAddresses. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Identity

O parâmetro Identity especifica o dispositivo móvel que você deseja visualizar. Você pode usar os seguintes valores que identificam exclusivamente o dispositivo móvel:

  • Identidade (<Mailbox Name>\ExchangeActiveSyncDevices\<MobileDeviceObjectName> por exemplo, CarlosM\ExchangeActiveSyncDevices\REST§Outlook§5eec4e941e0748a264512fd83770d5ac)
  • DN (nome diferenciado)
  • GUID (igual a ExchangeObjectId)

Não é possível usar esse parâmetro com o parâmetro Mailbox.

Type:MobileDeviceIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Mailbox

O parâmetro Caixa de Correio filtra os resultados pela caixa de correio do usuário associada ao dispositivo móvel. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domain\username
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN

Nome do banco de dados

Type:MailboxIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-NotificationEmailAddresses

O parâmetro NotificationEmailAddresses especifica uma lista separada por vírgulas de endereços de email para receber as estatísticas do dispositivo móvel quando você usa a opção GetMailboxLog.

Esse parâmetro só será significativo se você também usar a opção GetMailboxLog no mesmo comando.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-OWAforDevices

A opção OWAforDevices filtra os resultados por dispositivos em que Outlook na Web para dispositivos está habilitado. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-RestApi

A opção RestApi filtra os resultados por dispositivos de API REST. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-ShowRecoveryPassword

O comutador ShowRecoveryPassword especifica se deve retornar a senha de recuperação do dispositivo móvel como uma das estatísticas exibidas. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-UniversalOutlook

A opção UniversalOutlook filtra os resultados por dispositivos Mail e Calendar. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.