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 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.