Clear-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 Clear-ActiveSyncDevice para excluir todos os dados de um dispositivo móvel.

Observação: no Exchange 2013 ou posterior, use o cmdlet Clear-MobileDevice. Se você tiver scripts que usem o Clear-ActiveSyncDevice, atualize-os para usar o Clear-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

Clear-ActiveSyncDevice
     [-Identity] <ActiveSyncDeviceIdParameter>
     [-Cancel]
     [-Confirm]
     [-DomainController <Fqdn>]
     [-NotificationEmailAddresses <MultiValuedProperty>]
     [-WhatIf]
     [<CommonParameters>]

Description

O cmdlet Clear-ActiveSyncDevice exclui todos os dados de usuário de um dispositivo móvel na próxima vez que o dispositivo receber dados do Microsoft Exchange Server. Este cmdlet define o parâmetro DeviceWipeStatus como $true. O dispositivo móvel reconhece o cmdlet e registra o carimbo de data/hora no parâmetro DeviceWipeAckTime.

Após executar esse cmdlet, você receberá o seguinte aviso: "Todos os dados do dispositivo serão excluídos permanentemente. Deseja continuar?" Você deve responder ao aviso para que o cmdlet seja executado no telefone celular.

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

Clear-ActiveSyncDevice -Identity WM_JeffHay

Este exemplo limpa todos os dados do dispositivo móvel com a identidade WM _ JeffHay.

Exemplo 2

Clear-ActiveSyncDevice -Identity WM_TonySmith -NotificationEmailAddresses "tony@contoso.com"

Este exemplo apaga todos os dados do telefone celular de Antônio Teixeira e envia uma mensagem de email de confirmação para antônio@contoso.com.

Exemplo 3

Clear-ActiveSyncDevice -Identity WM_TonySmith -Cancel $true

Este exemplo cancela uma solicitação de comando Clear-ActiveSyncDevice enviada anteriormente ao dispositivo móvel de Antônio Teixeira.

Parameters

- Cancelar

A opção Cancel especifica se o comando deve ser cancelado. Se a opção Cancel for usada, uma solicitação de cancelamento é submetida novamente para o apagamento do dispositivo remoto.

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

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, Remover-* cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para esses cmdlets, você pode ignorar a solicitação de confirmação usando esta sintaxe exata: -Confirm:$false.

  • A maioria dos outros cmdlets (por exemplo, New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.

Type:SwitchParameter
Aliases:cf
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
-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
-Identity

O parâmetro Identity especifica a identidade do dispositivo a ser redefinido.

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

O parâmetro NotificationEmailAddresses especifica o endereço de email de notificação da confirmação de apagamento do dispositivo remoto.

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

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Aliases:wi
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.