Clear-ActiveSyncDevice
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2007-10-22
La cmdlet Clear-ActiveSyncDevice permet de supprimer toutes les données d'un périphérique mobile.
Syntaxe
Clear-ActiveSyncDevice -Identity <MobileDeviceIdParameter> [-Cancel <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-NotificationEmailAddresses <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]
Description détaillée
La cmdlet Clear-ActiveSyncDevice permet de supprimer toutes les données d'un périphérique mobile la prochaine fois que le périphérique reçoit des données du serveur exécutant Microsoft Exchange Server 2007. Cette cmdlet définit le paramètre DeviceWipeStatus sur $true. Le périphérique mobile accuse réception de la cmdlet et consigne l'horodateur dans le paramètre DeviceWipeAckTime.
Après avoir exécuté cette cmdlet, vous recevez un avertissement indiquant : « Cette commande entraînera la suppression définitive de toutes les données présentes sur ce périphérique. Voulez-vous continuer ? » Vous devez répondre à l'avertissement pour que la cmdlet s'exécute sur le périphérique mobile.
Pour exécuter la cmdlet Clear-ActiveSyncDevice, vous devez utiliser un compte auquel le rôle Administrateur de serveur Exchange et le groupe Administrateurs local ont été délégués pour le serveur cible.
Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange 2007, consultez la rubrique Considérations relatives aux autorisations.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
Microsoft.Exchange.Management.Tasks.MobileDeviceIdParameter |
Ce paramètre spécifie l'identité du périphérique à réinitialiser. |
Cancel |
Facultatif |
System.Boolean |
Ce paramètre spécifie si la cmdlet Clear-ActiveSyncDevice doit être annulée. Si vous utilisez le paramètre Cancel avec la cmdlet, une demande d'annulation est émise pour la réinitialisation à distance. |
Confirm |
Facultatif |
System.Management.Automation.SwitchParameter |
Ce paramètre spécifie si une confirmation est requise pour la réinitialisation à distance. Si ce paramètre est défini sur |
DomainController |
Facultatif |
Microsoft.Exchange.Data.Fqdn |
Ce paramètre spécifie le contrôleur de domaine auquel se connecter pour la validation Active Directory. |
NotificationEmailAddresses |
Facultatif |
Microsoft.Exchange.Data.MultiValuedProperty |
Ce paramètre spécifie l'adresse de messagerie de notification pour la confirmation de réinitialisation à distance. |
WhatIf |
Facultatif |
System.Management.Automation.SwitchParameter |
Ce paramètre donne pour instruction à la cmdlet de simuler les actions qu'elle va appliquer à un objet. Le paramètre WhatIf vous permet d'afficher les changements potentiels sans devoir les appliquer. La valeur par défaut est |
Types d'entrées
Types de retours
| Paramètre | Type | Description |
|---|---|---|
DeviceWipeSetTime |
System.DateTime |
Il s'agit de l'horodateur indiquant le moment auquel la tâche d'effacement à distance a été définie. |
Erreurs
| Erreur | Description |
|---|---|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
|
Exemple
L'exemple de code suivant efface toutes les données du périphérique mobile WM_JeffHay.
Clear-ActiveSyncDevice -Identity WM_JeffHay