Get-ActiveSyncDeviceStatistics

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-ActiveSyncDeviceStatistics para recuperar a lista de dispositivos móveis configurados para sincronizar com uma caixa de correio do usuário especificado e retornar uma lista de estatísticas sobre os dispositivos móveis. Observação : Este cmdlet funciona melhor no Exchange 2010. Em versões posteriores do Exchange Server ou Exchange Online, use o cmdlet Get-MobileDeviceStatistics. Se você tiver scripts que usam o Get-ActiveSyncDeviceStatistics, atualize-os para usar o Get-MobileDeviceStatistics.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax (https://docs.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

Syntax

Get-ActiveSyncDeviceStatistics
   [-Identity] <ActiveSyncDeviceIdParameter>
   [-DomainController <Fqdn>]
   [-GetMailboxLog]
   [-NotificationEmailAddresses <MultiValuedProperty>]
   [-ShowRecoveryPassword]
   [<CommonParameters>]
Get-ActiveSyncDeviceStatistics
   -Mailbox <MailboxIdParameter>
   [-DomainController <Fqdn>]
   [-GetMailboxLog]
   [-NotificationEmailAddresses <MultiValuedProperty>]
   [-ShowRecoveryPassword]
   [<CommonParameters>]

Description

O cmdlet Get-ActiveSyncDeviceStatistics 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.

Examples

Exemplo 1

Get-ActiveSyncDeviceStatistics -Mailbox TonySmith

Este exemplo recupera as estatísticas do celular configurado a serem sincronizadas com a caixa de correio que pertence ao usuário Tony Smith.

Exemplo 2

$UserList = Get-CASMailbox -Filter "HasActiveSyncDevicePartnership -eq `$true -and -not DisplayName -like 'CAS_{*'"; Get-Mailbox $UserList | foreach {Get-ActiveSyncDeviceStatistics -Mailbox $_}

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

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

Exemplo 3

Get-ActiveSyncDeviceStatistics -Mailbox TonySmith -GetMailboxLog $true -NotificationEmailAddresses "admin@contoso.com"

Este exemplo recupera as estatísticas do celular configurado a serem sincronizadas com a caixa de correio que pertence ao usuário Tony Smith. Ele também gera o arquivo de log do Exchange ActiveSync e o envia ao administrador do sistema em admin@contoso.com.

Parameters

-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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-GetMailboxLog

O parâmetro GetMailboxLog especifica se envia os logs de caixa de correio por email para o administrador que executa a tarefa. Se o parâmetro for definido como $true, o comando enviará os logs da caixa de correio por email para o administrador que executa a tarefa. O valor padrão deste parâmetro é $false.

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

O parâmetro Identity especifica a ID do dispositivo do usuário. Se o parâmetro Mailbox for especificado, o parâmetro Identity é desabilitado.

Type:ActiveSyncDeviceIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-Mailbox

O parâmetro Mailbox especifica a caixa de correio de usuário para a qual você deseja recuperar as estatísticas do telefone celular. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:

  • Nome

  • Alias

  • Nome diferenciado (DN)

  • Nome diferenciado (DN)

  • <domain name>\<account name>

  • DN canônico

  • GUID

  • LegacyExchangeDN

  • SamAccountName

  • ID de usuário ou nome UPN

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

O parâmetro NotificationEmailAddresses especifica uma lista opcional de aliases ou endereços de email separados por vírgula em que os logs da caixa de correio são enviados. Se o parâmetro GetMailboxLog for definido como $false, esse parâmetro será ignorado.

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

O parâmetro ShowRecoveryPassword especifica se a senha de recuperação do telefone celular deve ser retornada como uma das estatísticas exibidas. Se o parâmetro for definido como $true, o comando retorna a senha de recuperação do telefone celular como uma das estatísticas exibidas.

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

Inputs

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.

Outputs

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.