Get-ActiveSyncDevice

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-ActiveSyncDevice para recuperar a lista de dispositivos em sua organização que têm parcerias ativas do Exchange ActiveSync.

Observação: no Exchange 2013 ou posterior, use o cmdlet Get-MobileDevice. Se você tiver scripts que usam o Get-ActiveSyncDevice, atualize-os para usar o Get-MobileDevice.

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-ActiveSyncDevice
   -Mailbox <MailboxIdParameter>
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [-Monitoring]
   [<CommonParameters>]
Get-ActiveSyncDevice
   [[-Identity] <ActiveSyncDeviceIdParameter>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [-Monitoring]
   [<CommonParameters>]

Description

O cmdlet Get-ActiveSyncDevice retorna as informações de identificação, configuração e status de cada dispositivo.

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-ActiveSyncDevice -Identity "TonySmith"

Este exemplo retorna todos os dispositivos móveis do Exchange ActiveSync que Tony Smith usou e que estão associados à sua caixa de correio.

Exemplo 2

Get-ActiveSyncDevice -Mailbox "Redmond\TonySmith"

Este exemplo retorna todos os dispositivos móveis do Exchange ActiveSync que Tony Smith usou e que estão associados à sua caixa de correio.

Parameters

- Monitoramento

Este parâmetro está disponível somente no Exchange local.

A opção de monitoramento é necessária para retornar caixas de correio de monitoramento nos resultados. Não é preciso especificar um valor com essa opção.

As caixas de correio de monitoramento são associadas à disponibilidade gerenciada e ao serviço Gerenciador de integridade do Exchange e têm um valor de propriedade RecipientTypeDetails de MonitoringMailbox.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-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
-Filter

O parâmetro Filter usa a sintaxe OPath para filtrar os resultados de acordo com as propriedades e os valores especificados. Os critérios de pesquisa usam a sintaxe "Property -ComparisonOperator 'Value'" .

  • Coloque todo o filtro OPath entre aspas duplas "". Se o filtro contiver valores de sistema (por exemplo,, $true $false ou $null ), use aspas simples. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco de sistema), você também pode usar chaves {}, mas somente se o filtro não contiver variáveis.

  • Propriedade é uma propriedade filtrável.

  • ComparisonOperator é um operador de comparação de OPath (por exemplo -eq , igual a e -like para comparação de cadeia de caracteres). Para obter mais informações sobre operadores de comparação, consulte about_Comparison_Operators.

  • Value é o valor da propriedade a ser pesquisada. Coloque valores de texto e variáveis entre aspas simples ( 'Value' ou '$Variable' ). Se um valor de variável contiver aspas simples, você precisará identificar (escapar) as aspas simples para expandir a variável corretamente. Por exemplo, em vez de '$User' , use '$($User -Replace "'","''")' . Não coloque números inteiros ou valores do sistema (por exemplo,,, 500 $true $false ou $null ).

Você pode encadear vários critérios de pesquisa juntos usando os operadores lógicos -and e -or . Por exemplo, "Criteria1 -and Criteria2" ou "(Criteria1 -and Criteria2) -or Criteria3" .

Para obter informações detalhadas sobre filtros do OPath no Exchange, consulte Additional OPATH Syntax Information.

É possível filtrar pelas seguintes propriedades:

  • ClientType

  • DeviceAccessControlRule

  • DeviceAccessState

  • DeviceAccessStateReason

  • DeviceActiveSyncVersion

  • DeviceId

  • DeviceImei

  • DeviceMobileOperator

  • DeviceModel

  • DeviceOS

  • DeviceOSLanguage

  • DeviceTelephoneNumber

  • DeviceType

  • DeviceUserAgent

  • FirstSyncTime

  • FriendlyName

  • ProvisioningFlags

  • NomeParaExibiçãoDoUsuário

Type:String
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 o dispositivo ActiveSync que você deseja exibir. É possível usar qualquer valor que identifique o dispositivo com exclusividade. Por exemplo:

  • GUID

  • DeviceIdentity

  • Multilocatárioid

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 que tem o dispositivo ActiveSync associado que você deseja exibir. É 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
-OrganizationalUnit

O parâmetro OrganizationalUnit filtra os resultados com base no local do objeto no Active Directory. Somente objetos que existem na localização especificada são retornados. A entrada válida para esse parâmetro é uma UO (unidade organizacional) ou um domínio retornado pelo cmdlet Get-OrganizationalUnit. É possível usar qualquer valor que identifique a UO ou o domínio com exclusividade. Por exemplo:

  • Nome

  • Nome

  • Nome diferenciado (DN)

  • GUID

Type:OrganizationalUnitIdParameter
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
-Resultados

O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Caso pretenda retornar todas as solicitações correspondentes à consulta, use unlimited como valor desse parâmetro. O valor padrão é 1000.

Type:Unlimited
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
-SortBy

O parâmetro SortBy especifica a propriedade pela qual classificar os resultados. Você pode classificar apenas por uma propriedade de cada vez. Os resultados são classificados em ordem crescente.

Se o modo de exibição padrão não incluir a propriedade que você está classificando, você pode anexar o comando com | Format-Table-auto <Property1> , <Property2> ... para criar um novo modo de exibição que contenha todas as propriedades que você deseja ver. Há suporte para caracteres curinga ( * ) nos nomes das propriedades.

É possível classificar pelas seguintes propriedades:

  • DeviceAccessControlRule

  • DeviceAccessState

  • DeviceAccessStateReason

  • DeviceId

  • DeviceImei

  • DeviceMobileOperator

  • DeviceModel

  • DeviceOS

  • DeviceOSLanguage

  • DeviceTelephoneNumber

  • DeviceType

  • DeviceUserAgent

  • FirstSyncTime

  • FriendlyName

  • NomeParaExibiçãoDoUsuário

Type:String
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.