Get-ActiveSyncDeviceStatistics

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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 ou Exchange Online, use o cmdlet Get-MobileDeviceStatistics. Se você tiver scripts que usam Get-ActiveSyncDeviceStatistics, atualize-os para usar Get-MobileDeviceStatistics.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte 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.

Exemplos

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 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-ActiveSyncDeviceStatistics -Mailbox TonySmith -GetMailboxLog -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 Exchange ActiveSync e o envia para o Administrador do Sistema em admin@contoso.com.

Parâmetros

-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 2010, 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 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
Required:True
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\username
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN
Type:MailboxIdParameter
Position:Named
Default value:None
Required:True
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 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 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, 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.