Compartilhar via


Get-MobileDeviceStatistics

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

Utilize o cmdlet Get-MobileDeviceStatistics para obter a lista de dispositivos móveis configurados para sincronizar com a caixa de correio de um utilizador especificado e devolver uma lista de estatísticas sobre os dispositivos móveis.

Nota: no Exchange Online PowerShell, recomendamos que utilize o cmdlet Get-EXOMobileDeviceStatistics em vez deste 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.

Sintaxe

Identity

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

Mailbox

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

Description

O cmdlet Get-MobileDeviceStatistics devolve 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 artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 obtém as estatísticas do telemóvel 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 utiliza o cmdlet Get-CASMailbox para determinar quem na organização tem um dispositivo móvel Exchange ActiveSync. Para cada dispositivo móvel, são obtidas as estatísticas Exchange ActiveSync dispositivo.

Nota: para obter mais informações sobre a sintaxe do filtro OPATH, veja Informações adicionais sobre sintaxe OPATH.

Exemplo 3

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

Este exemplo obtém as estatísticas do telemóvel que está configurado para sincronizar com a caixa de correio de Tony Smith. Também produz o ficheiro de registo e envia-o para o Administrador de Sistema em admin@contoso.com.

Parâmetros

-ActiveSync

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DomainController

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Propriedades do parâmetro

Tipo:Fqdn
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-GetMailboxLog

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro Identity especifica o dispositivo móvel que você deseja visualizar. Pode utilizar 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 ao ExchangeObjectId)

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

Atenção: o valor $null ou um valor inexistente para o parâmetro Identidade devolve todos os objetos como se tivesse executado o comando Get- sem o parâmetro Identity. Verifique se as listas de valores do parâmetro Identity estão corretas e não contêm valores de $null inexistentes.

Propriedades do parâmetro

Tipo:MobileDeviceIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Identity
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Mailbox

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro Caixa de Correio filtra os resultados pela caixa de correio do utilizador que está 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)
  • Domínio\Nome de Utilizador
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN

Nome do banco de dados

Propriedades do parâmetro

Tipo:MailboxIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Mailbox
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-NotificationEmailAddresses

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro NotificationEmailAddresses especifica uma lista separada por vírgulas de endereços de e-mail para receber as estatísticas dos dispositivos móveis quando utiliza o comutador GetMailboxLog.

Este parâmetro é significativo apenas se também utilizar o comutador GetMailboxLog no mesmo comando.

Propriedades do parâmetro

Tipo:MultiValuedProperty
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-OWAforDevices

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O comutador OWAforDevices filtra os resultados por dispositivos onde a Outlook na Web para dispositivos está ativada. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RestApi

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ShowRecoveryPassword

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O comutador ShowRecoveryPassword especifica se pretende devolver a palavra-passe de recuperação do dispositivo móvel como uma das estatísticas apresentadas. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UniversalOutlook

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O comutador UniversalOutlook filtra os resultados por dispositivos Correio e Calendário. Não é preciso especificar um valor com essa opção.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UseCustomRouting

Aplicável: Exchange Online

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

{{ Fill UseCustomRouting Description }}

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo 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, confira about_CommonParameters.

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.