Clear-ActiveSyncDevice
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 |
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 |
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