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 $true, un message électronique de confirmation est envoyé à l'adresse électronique de notification et au propriétaire du périphérique une fois la réinitialisation à distance terminée.
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 $false.

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