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.