Clear-ActiveSyncDevice

  • Artikel

 

Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Letztes Änderungsdatum des Themas: 2007-10-22

Das Cmdlet Clear-ActiveSyncDevice ermöglicht Ihnen das Löschen der gesamten Daten von einem mobilen Gerät.

Syntax

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

Detaillierte Beschreibung

Das Cmdlet Clear-ActiveSyncDevice ermöglicht Ihnen das Löschen der gesamten Daten eines mobilen Geräts beim nächsten Empfang von Daten durch dieses Gerät von dem Server, der Microsoft Exchange Server 2007 ausführt. Dieses Cmdlet legt den Parameter DeviceWipeStatus auf $true fest. Das mobile Gerät erkennt das Cmdlet und zeichnet den Zeitstempel im Parameter DeviceWipeAckTime auf.

Nachdem Sie dieses Cmdlet ausgeführt haben, erhalten Sie eine Warnung mit folgendem Inhalt: "Dieser Befehl erzwingt das endgültige Löschen aller Daten auf dem Gerät. Möchten Sie fortfahren?" Sie müssen auf diese Warnung reagieren, damit das Cmdlet auf dem mobilen Gerät ausgeführt wird.

Damit Sie das Cmdlet Clear-ActiveSyncDevice ausführen können, muss dem verwendeten Konto die Rolle Exchange-Serveradministrator zugewiesen worden sein, und es muss der lokalen Gruppe Administratoren für den Zielserver angehören.

Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Exchange 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Microsoft.Exchange.Management.Tasks.MobileDeviceIdParameter

Dieser Parameter gibt die Identität des Geräts an, das Sie zurücksetzen möchten.

Cancel

Optional

System.Boolean

Dieser Parameter gibt an, ob die Ausführung des Cmdlets Clear-ActiveSyncDevice abgebrochen werden soll. Bei Verwendung des Parameters Cancel in Verbindung mit dem Cmdlet Clear-ActiveSyncDevice wird eine Abbruchanforderung für die Löschung des Remotegeräts ausgegeben.

Confirm

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter gibt an, ob für die Löschung des Remotegeräts eine Bestätigung erfolgen muss. Bei Angabe von $true wird nach Abschluss des Löschvorgangs des Remotegeräts eine Bestätigungs-E-Mail-Nachricht an die Benachrichtungs-E-Mail-Adresse und an den Besitzer des Geräts gesendet.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Dieser Parameter gibt den Domänencontroller an, mit dem zur Active Directory-Überprüfung eine Verbindung hergestellt werden soll.

NotificationEmailAddresses

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Dieser Parameter gibt die Benachrichtigungs-E-Mail-Adresse für die Bestätigung des Löschvorgangs des Remotegeräts an.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter weist das Cmdlet an, die Aktionen zu simulieren, die für ein Objekt ausgeführt würden. Durch Verwendung des WhatIf-Parameters können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Der Standardwert ist $false.

Eingabetypen

Rückgabetypen

Parameter Typ Beschreibung

 DeviceWipeSetTime

System.DateTime

Dies ist der Zeitstempel, der angibt, wann der Task für den Remotelöschvorgang festgelegt wurde.

Fehler

Fehler Beschreibung

  

 

Ausnahmen

Ausnahmen Beschreibung

 

  

Beispiel

Das folgende Codebeispiel löscht alle Daten vom mobilen Gerät "WM_JeffHay".

Clear-ActiveSyncDevice -Identity WM_JeffHay