Clear-ActiveSyncDevice

  • Artículo

 

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2007-10-22

El cmdlet Clear-ActiveSyncDevice le permite eliminar todos los datos de un dispositivo móvil.

Sintaxis

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

Descripción detallada

El cmdlet Clear-ActiveSyncDevice le permite eliminar todos los datos de un dispositivo móvil la próxima vez que el dispositivo reciba datos del servidor que está ejecutando Microsoft Exchange Server 2007. Este cmdlet establece el parámetro DeviceWipeStatus en $true. El dispositivo móvil reconocerá el cmdlet y registrará la marca de tiempo en el parámetro DeviceWipeAckTime.

Después de ejecutar este cmdlet, recibirá la siguiente advertencia: "Este comando forzará a eliminar de forma permanente todos los datos del dispositivo. ¿Desea continuar?" Debe responder a la advertencia para que el cmdlet se ejecute en el dispositivo móvil.

Para ejecutar el cmdlet Clear-ActiveSyncDevice, la cuenta que utilice debe tener delegada la función Administrador de Exchange Server y pertenecer al grupo Administradores local para el servidor de destino.

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro Necesario Tipo Descripción

Identity

Necesario

Microsoft.Exchange.Management.Tasks.MobileDeviceIdParameter

Este parámetro especifica la identidad del dispositivo que desea restablecer.

Cancel

Opcional

System.Boolean

Este parámetro especifica si el cmdlet Clear-ActiveSyncDevice se debe cancelar. Si usa el parámetro Cancel con el cmdlet Clear-ActiveSync, se emitirá una solicitud de cancelación para la eliminación remota de datos del dispositivo móvil.

Confirm

Opcional

System.Management.Automation.SwitchParameter

Este parámetro especifica si se necesita confirmación para la eliminación remota de datos del dispositivo móvil. Si se establece en $true, se enviará un mensaje de correo electrónico de confirmación a la dirección de correo electrónico de notificaciones y al propietario del dispositivo cuando se complete una eliminación remota de datos del dispositivo móvil.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Este parámetro especifica el controlador de dominio al que conectarse para la validación de Active Directory.

NotificationEmailAddresses

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Este parámetro especifica la dirección de correo electrónico de notificaciones para la confirmación de la eliminación remota de datos del dispositivo móvil.

WhatIf

Opcional

System.Management.Automation.SwitchParameter

Este parámetro indica al cmdlet que simule las acciones que llevaría a cabo en un objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. El valor predeterminado es $false.

Tipos de entrada

Tipos de valores devueltos

Parámetro Tipo Descripción

 DeviceWipeSetTime

System.DateTime

ésta es la marca de tiempo que indica cuándo se ha establecido la tarea de limpieza remota.

Errores

Error Descripción

  

 

Excepciones

Excepciones Descripción

 

  

Ejemplo

El siguiente ejemplo de código elimina todos los datos del dispositivo móvil WM_JeffHay.

Clear-ActiveSyncDevice -Identity WM_JeffHay