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