Share via

Clear-ActiveSyncDevice

  • Artigo

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2007-10-22

O cmdlet Clear-ActiveSyncDevice permite excluir todos os dados de um dispositivo móvel.

Sintaxe

Clear-ActiveSyncDevice -Identity <MobileDeviceIdParameter> [-Cancel <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-NotificationEmailAddresses <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]

Descrição detalhada

O cmdlet Clear-ActiveSyncDevice permite excluir todos os dados de um dispositivo móvel na próxima vez em que o dispositivo receber dados do servidor que está executando o Microsoft Exchange Server 2007. Esse cmdlet define o parâmetro DeviceWipeStatus como $true. O dispositivo móvel reconhecerá o cmdlet e gravará 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 comando seja executado no dispositivo móvel.

Para executar o cmdlet Clear-ActiveSyncDevice, você deve usar uma conta à qual esteja delegada a função Administrador do Exchange Server e o grupo Administradores local do servidor de destino.

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Exchange 2007, consulte Considerações sobre permissão. 

Parâmetros

Parâmetro Necessário Tipo Descrição

Identity

Necessário

Microsoft.Exchange.Management.Tasks.MobileDeviceIdParameter

Esse parâmetro especifica a identidade do dispositivo a ser redefinido.

Cancel

Opcional

System.Boolean

Esse parâmetro especifica se o cmdlet Clear-ActiveSyncDevice deve ser cancelado. Se você usar o parâmetro Cancel com o cmdlet Clear-ActiveSync, uma solicitação de cancelamento será emitida para o apagamento remoto de dispositivo.

Confirm

Opcional

System.Management.Automation.SwitchParameter

Esse parâmetro especifica se é exigida uma confirmação para o apagamento remoto de dispositivo. Se definido como $true, uma mensagem de email de confirmação será enviada ao endereço de email de notificação e ao proprietário do dispositivo quando o apagamento remoto de dispositivo for concluído.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Esse parâmetro especifica o controlador de domínio ao qual se conectar para validação do Active Directory.

NotificationEmailAddresses

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

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

WhatIf

Opcional

System.Management.Automation.SwitchParameter

Esse parâmetro instrui o cmdlet a simular as ações que ele executaria em um objeto. Ao usar o parâmetro WhatIf, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. O valor padrão é $false.

Tipos de entrada

Tipos de retorno

Parâmetro Tipo Descrição

 DeviceWipeSetTime

System.DateTime

Este é o carimbo de data/hora que indica quando a tarefa de apagamento remota foi definida.

Erros

Erro Descrição

  

 

Exceções

Exceções Descrição

 

  

Exemplo

O exemplo de código a seguir limpa todos os dados do dispositivo móvel WM_JeffHay.

Clear-ActiveSyncDevice -Identity WM_JeffHay