Clear-ActiveSyncDevice

Artigo
09/30/2014

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

Exceçõ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

Compartilhar via