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 Exchange ActiveSync ativas.
Observação: no Exchange 2013 ou posterior, use o cmdlet Get-MobileDevice. Se você tiver scripts que usam Get-ActiveSyncDevice, atualize-os para usar Get-MobileDevice.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte 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 informações de identificação, configuração e status para 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.
Exemplos
Exemplo 1
Get-ActiveSyncDevice -Mailbox "TonySmith"
Este exemplo retorna todos os Exchange ActiveSync dispositivos móveis que Tony Smith usou e que estão associados à sua caixa de correio.
Exemplo 2
Get-ActiveSyncDevice -ResultSize Unlimited | Where {$_.DeviceOS -eq "OutlookBasicAuth"} | Format-Table -Auto UserDisplayName,DeviceAccessState
Este exemplo retorna os nomes de proprietário de todos os dispositivos móveis Exchange ActiveSync que se conectam por meio do aplicativo Outlook Mobile usando a Autenticação Básica.
Exemplo 3
Get-ActiveSyncDevice -ResultSize Unlimited | Where {$_.DeviceType -eq "OutlookService"} | Format-Table -Auto UserDisplayName,FirstSyncTime
Este exemplo retorna os nomes de proprietário de todos os aplicativos do Outlook Mobile que são sincronizados por meio da Autenticação Moderna Híbrida.
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 |
-Filter
O parâmetro Filter usa a sintaxe OPATH para filtrar os resultados pelas propriedades e valores especificados. Os critérios de pesquisa usam a sintaxe "Property -ComparisonOperator 'Value'"
.
- Inclua todo o filtro OPATH nas aspas duplas " ". Se o filtro contiver valores do sistema (por exemplo,
$true
,$false
ou$null
), use aspas individuais ' ' em vez disso. Embora esse parâmetro seja uma cadeia de caracteres (não um bloco do sistema), você também pode usar chaves { }, mas somente se o filtro não contiver variáveis. - A propriedade é uma propriedade filtrada.
- ComparisonOperator é um operador de comparação OPATH (por exemplo
-eq
, para iguais e-like
para comparação de cadeia de caracteres). Para obter mais informações sobre operadores de comparação, consulte about_Comparison_Operators. - Valor é o valor da propriedade a ser pesquisado. Inclua valores e variáveis de texto em aspas individuais (
'Value'
ou'$Variable'
). Se um valor variável contiver aspas individuais, você precisará identificar (escapar) as aspas individuais para expandir a variável corretamente. Por exemplo, em vez de'$User'
, use'$($User -Replace "'","''")'
. Não inclua inteiros ou valores do sistema entre aspas (por exemplo, use500
,$true
,$false
ou$null
em vez disso).
Você pode encadear vários critérios de pesquisa 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 OPATH no Exchange, consulte Informações adicionais de sintaxe OPATH.
É possível filtrar pelas seguintes propriedades:
- ClientType
- DeviceAccessControlRule
- DeviceAccessState
- DeviceAccessStateReason
- DeviceActiveSyncVersion
- DeviceId
- DeviceImei
- DeviceMobileOperator
- DeviceModel
- DeviceOS
- DeviceOSLanguage
- DeviceTelephoneNumber
- DeviceType
- DeviceUserAgent
- FirstSyncTime
- FriendlyName
- ProvisionamentoFlags
- NomeParaExibiçãoDoUsuário
Type: | String |
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 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 |
Required: | False |
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 Caixa de correio 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\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 |
-Monitoring
Este parâmetro está disponível somente no Exchange local.
A opção 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 estão associadas à disponibilidade gerenciada e ao serviço do Exchange Health Manager e têm um valor de propriedade RecipientTypeDetails do MonitoringMailbox.
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 |
-OrganizationalUnit
O parâmetro OrganizationalUnit filtra os resultados com base na localização 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 OU (unidade organizacional) ou 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 |
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 |
-ResultSize
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 |
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 |
-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 a exibição padrão não incluir a propriedade pela qual você está classificando, você poderá acrescentar o comando com | Format-Table -Auto Property1,Property2,...PropertyX
. para criar uma nova exibição que contenha todas as propriedades que você deseja ver. Os caracteres curinga (*) nos nomes de propriedade são permitidos.
É 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 |
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.