Set-UMMailboxPIN

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2007-06-28

La cmdlet Set-UMMailboxPIN redéfinit le code confidentiel d'une boîte aux lettres à extension messagerie unifiée.

Syntaxe

Set-UMMailboxPIN -Identity <MailboxIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-LockedOut <$true | $false>] [-NotifyEmail <String>] [-Pin <String>] [-PinExpired <$true | $false>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet Set-UMMailboxPIN est utilisée quand un utilisateur à MU activée est interdit d'accès à sa boîte aux lettres parce qu'il a tenté d'ouvrir une session en utilisant un code PIN incorrect à plusieurs reprises ou parce qu'il a oublié son code PIN. Vous pouvez utiliser cette cmdlet pour définir le code PIN de l'utilisateur. Le nouveau code PIN doit être conforme aux règles de stratégie de code PIN spécifiées dans la stratégie de boîte aux lettres de l'utilisateur. Le nouveau code PIN est envoyé à l'utilisateur dans un message électronique ou envoyé à une autre adresse de messagerie. Vous pouvez contrôler si l'utilisateur doit redéfinir le code confidentiel lors de l'ouverture de session et si la boîte aux lettres doit rester verrouillée.

Pour exécuter la cmdlet Set-UMMailboxPIN, vous devez utiliser un compte auquel le rôle Administrateur des destinataires Exchange a été délégué.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Ce paramètre spécifie l'utilisateur à activer pour la messagerie unifiée. Les variables pour ce paramètre sont les suivantes :

  • ADObjectID

  • GUID

  • DN

  • Domaine\Compte

  • UPN

  • LegacyExchangeDN

  • SmtpAddress

  • Alias

Ce paramètre est obligatoire si le paramètre Instance n'est pas utilisé.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre suspend le traitement par la commande et vous demande de confirmer les actions que la commande va effectuer avant de continuer le traitement. La valeur par défaut est $true.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre spécifie le nom de domaine complet du contrôleur de domaine qui écrit ce changement de configuration dans le service d'annuaire Active Directory.

IgnoreDefaultScope

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre donne pour instruction à la commande d'ignorer le paramétrage de la portée du destinataire par défaut pour l'environnement de ligne de commande Exchange Management Shell et d'utiliser l'ensemble de la forêt comme portée. Cela permet à la commande d'accéder à des objets Active Directory ne figurant pas actuellement dans la portée par défaut. L'utilisation du paramètre IgnoreDefaultScope introduit les restrictions suivantes :

  • Vous ne pouvez pas utiliser le paramètre DomainController. La commande utilisera automatiquement un serveur de catalogue global approprié.

  • Vous ne pouvez utiliser le nom unique que pour le paramètre Identity. D'autres formes d'identification, telles qu'un alias ou un GUID, ne sont pas acceptées.

LockedOut

Facultatif

System.Boolean

Ce paramètre spécifie si la boîte aux lettres doit rester verrouillée. S'il est défini sur $true, la boîte aux lettres est marquée comme verrouillée. Par défaut, si ce paramètre est omis ou défini sur $false, la tâche supprime le verrouillage d'une boîte aux lettres.

NotifyEmail

Facultatif

System.String

Ce paramètre spécifie l'adresse de messagerie à laquelle le serveur enverra le message électronique contenant les informations de réinitialisation du code confidentiel. Par défaut, le message est envoyé à l'adresse SMTP de l'utilisateur activé.

Pin

Facultatif

System.String

Ce paramètre spécifie un nouveau code PIN à utiliser avec cette boîte aux lettres. Le code PIN est comparé aux règles de code PIN définies dans la stratégie de MU. Si le code PIN n'est pas fourni, la tâche génère un nouveau code PIN pour la boîte aux lettres et l'inclut dans un message électronique envoyé à l'utilisateur.

PINExpired

Facultatif

System.Boolean

Ce paramètre spécifie si le code PIN sera traité comme expiré. Si ce paramètre est fourni et défini sur $false, l'utilisateur ne doit pas redéfinir son code PIN lors de l'ouverture de session suivante. Si le code PIN n'est pas fourni, il est traité comme expiré et l'utilisateur est invité à redéfinir son code PIN lors de l'ouverture de session suivante.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. La valeur par défaut est $true.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

 

Exemple

Le premier exemple redéfinit le code confidentiel de la boîte aux lettres à extension messagerie unifiée activée pour yanli@contoso.com.

Le deuxième exemple redéfinit le code confidentiel initial de la boîte aux lettres à extension messagerie unifiée pour yanli@contoso.com sur 1985848, puis définit le code confidentiel comme expiré de manière à ce que l'utilisateur soit invité à modifier le code confidentiel lors de sa connexion suivante.

Le troisième exemple verrouille la boîte aux lettres à extension messagerie unifiée pour yanli@contoso.com afin d'empêcher les utilisateurs d’accéder à leur boîte aux lettres.

Le quatrième exemple déverrouille la boîte aux lettres à extension messagerie unifiée pour yanli@contoso.com et autorise les utilisateurs à accéder à leur boîte aux lettres.

Set-UMMailboxPIN -Identity yanli@contoso.com

Set-UMMailboxPIN -Identity yanli@contoso.com -PIN 1985848 -PinExpired $true

Set-UMMailboxPIN -Identity yanli@contoso.com -LockedOut $true

Set-UMMailboxPIN -Identity yanli@contoso.com -LockedOut $false