Identité

S’applique à : Exchange Server 2013

Le paramètre Identity est un paramètre spécial que vous pouvez utiliser avec la plupart des applets de commande. Le paramètre Identity vous donne accès aux identificateurs uniques qui font référence à un objet spécifique dans Microsoft Exchange Server 2013. Cela vous permet d'appliquer des actions à un objet Exchange 2013 spécifique.

Les sections suivantes décrivent le paramètre Identity et donnent des exemples vous montrant comment l'utiliser efficacement :

Characteristics of the Identity parameter

Wildcard characters in Identity

Examples of the Identity parameter

Caractéristiques du paramètre Identity

L'identificateur unique principal d'un objet dans Exchange 2013 est toujours un GUID. Un GUID est un identificateur 128 bits, tel que 63d64005-42c5-4f8f-b310-14f6cb125bf3. Le GUID n'est jamais répété et est donc toujours unique. En revanche, vous ne pouvez pas entrer de tels GUID régulièrement. Par conséquent, le paramètre Identity se compose généralement également des valeurs d’autres paramètres, ou d’un ensemble combiné de valeurs de plusieurs paramètres sur un seul objet. Ces valeurs sont également uniques. Vous pouvez spécifier les valeurs de ces autres paramètres, tels que Name et DistriguishedName, ou ils peuvent être générés par le système. Les paramètres supplémentaires éventuellement utilisés et la manière dont ils sont renseignés dépend de l'objet auquel vous faites référence.

Le paramètre Identity est également considéré comme un paramètre positionnel. Le premier argument d’une applet de commande est supposé être le paramètre Identity lorsqu’aucune étiquette de paramètre n’est spécifiée. Cela réduit le nombre de frappes lorsque vous tapez les commandes. Pour plus d'informations sur les paramètres positionnels, voir Parameters.

L’exemple suivant illustre l’utilisation du paramètre Identity à l’aide de la valeur unique du paramètre Name du connecteur Receive. Cet exemple montre également comment omettre le nom du paramètre Identity , car Identity est un paramètre positionnel.

Get-ReceiveConnector -Identity "From the Internet"
Get-ReceiveConnector "From the Internet"

Comme tous les objets dans Exchange 2013, ce connecteur de réception peut également être désigné par son GUID unique. Par exemple, si le connecteur de réception nommé "From the Internet" reçoit également le GUID 63d64005-42c5-4f8f-b310-14f6cb125bf3, vous pouvez également récupérer le connecteur de réception à l’aide de la commande suivante :

Get-ReceiveConnector 63d64005-42c5-4f8f-b310-14f6cb125bf3

Caractères génériques dans Identity

Certaines applets de commande Get peuvent accepter un caractère générique (*) dans le cadre de la valeur que vous envoyez à Identity lorsque vous exécutez l’applet de commande. En utilisant un caractère générique avec le paramètre Identity , vous pouvez spécifier un nom partiel et récupérer une liste d’objets qui correspondent à ce nom partiel. Vous pouvez placer un caractère générique au début ou à la fin de la valeur Identity , mais vous ne pouvez pas placer le caractère au milieu d’une chaîne. Par exemple, les commandes et Get-Mailbox _anders* sont validesGet-Mailbox David*, mais Get-Mailbox Reb*ca n’est pas une commande valide.

Certaines cmdlets Get permettent d'extraire des objets dans Exchange 2013, organisés dans une relation hiérarchique ou de parent et enfants. En d'autres termes, une collection d'objets parents peut donc contenir ses propres objets enfants. Les objets qui ont une relation parent et enfant peuvent avoir une identité avec la syntaxe .<parent>\<child>

Lorsqu’un paramètre Identity a la syntaxe , certaines applets de <parent>\<child>commande vous permettent d’utiliser un caractère générique (*) pour remplacer tout ou partie des noms parents ou enfants. Par exemple, si vous souhaitez trouver tous les objets enfants nommés « Contoso » dans tous les objets parents, vous pouvez utiliser la syntaxe "*\Contoso". De même, si vous souhaitez rechercher tous les objets enfants avec un nom partiel « Auth » qui existent sous l’objet "ServerA" parent, vous pouvez utiliser la syntaxe "ServerA\Auth*".

Certaines des cmdlets, mais pas toutes, vous permettent de spécifier seulement la partie enfant du paramètre Identity lorsque vous exécutez une commande. Dans ce cas, les cmdlets s'exécutent par défaut sur l'objet parent actuel de l'objet enfant recherché. Par exemple, deux connecteurs de réception appelés « Contoso Receive Connector » existent sur les serveurs MBX1 et MBX2. Si vous exécutez la commande Get-ReceiveConnector "Contoso Receive Connector" sur MBX2, seul le connecteur de réception sur le serveur MBX2 est retourné.

Le comportement du paramètre Identity et des caractères génériques dépend de la cmdlet qui est exécutée. Pour plus d'informations sur la cmdlet que vous exécutez, examinez son contenu.

Exemples du paramètre Identity

Les exemples décrits dans cette rubrique illustrent comment le paramètre Identity peut accepter différentes valeurs uniques pour faire référence à des objets spécifiques dans l’organisation Exchange 2013. Ils montrent également comment omettre l’étiquette du paramètre Identity pour réduire le nombre de frappes nécessaires pour taper les commandes.

messages DSN

Les exemples fournis dans cette section font référence aux messages de notification d'état de remise (DSN) que vous pouvez configurer dans une organisation Exchange 2013. Le premier exemple montre comment extraire DSN 5.4.1 à l'aide de la cmdlet Get-SystemMessage. Dans l’applet de commande Get-SystemMessage , le paramètre Identity se compose de plusieurs éléments de données configurés sur chaque objet de message DSN. Ces éléments de données indiquent la langue dans laquelle la DSN est écrite, si sa portée est interne ou externe et le code du message DSN comme dans l'exemple suivant :

Get-SystemMessage en\internal\5.4.1

Vous pouvez également extraire ce message DSN à l'aide de son GUID comme dans l'exemple suivant, car tous les objets dans Exchange 2013 ont un GUID :

Get-SystemMessage 82ca7bde-1c2d-4aa1-97e1-f298a6f10222

Pour plus d’informations sur la composition du paramètre Identity lorsqu’il est utilisé avec les applets de commande SystemMessage , consultez Identité de message DSN.

Entrées de rôles de gestion

Les exemples de cette section font référence aux entrées de rôle de gestion qui constituent les rôles de gestion dans Exchange 2013. Les rôles de gestion permettent de contrôler les autorisations qui sont accordées aux administrateurs et aux utilisateurs finaux. Les entrées de rôle de gestion sont constituées de deux parties : le rôle de gestion auquel elles sont associées et une cmdlet. Le paramètre Identity est de même constitué du nom du rôle de gestion et du nom de la cmdlet. Par exemple, voici l’entrée de rôle pour l’applet de commande Set-Mailbox sur le Mail Recipients rôle :

Mail Recipients\Set-Mailbox

L’entrée Mail Recipients\Set-Mailbox de rôle est l’une des entrées du Mail Recipients rôle. Pour afficher toutes les entrées de rôle sur le Mail Recipients rôle, vous pouvez utiliser la commande suivante :

Get-ManagementRoleEntry "Mail Recipients\*"

Pour afficher toutes les entrées de rôle sur le Mail Recipients rôle qui contiennent la chaîne «Mailbox », utilisez la commande suivante :

Get-ManagementRoleEntry "Mail Recipients\*Mailbox*"

Pour afficher tous les rôles de gestion pour lequel Set-Mailbox est l'une des entrées de rôle, utilisez la commande suivante :

Get-ManagementRoleEntry *\Set-Mailbox

With role entries you can use the wildcard character in a variety of ways to query Exchange 2013 for the information you're interested in.

Pour plus d'informations sur les rôles de gestion, voir Présentation des rôles de gestion.