Modifier une entrée de rôle

  • Article

S’applique à : Exchange Server 2013

Chaque entrée de rôle de gestion représente une cmdlet unique. En ajoutant ou en supprimant des paramètres dans une entrée de rôle, qui est alors ajoutée à un rôle de gestion, vous contrôlez la disponibilité des paramètres sur la cmdlet. Pour plus d'informations sur les entrées de rôles de gestion dans Microsoft Exchange Server 2013, voir Présentation des rôles de gestion.

Vous ne pouvez pas modifier les entrées de rôle des rôles de gestion intégrés.

Remarque

Cette rubrique ne décrit pas comment modifier les entrées des rôles de gestion non délimitées d'un rôle de gestion non délimité. Pour plus d'informations sur la modification des entrées de rôle non délimitées, consultez la rubrique Créer un rôle.

Avertissement

Pour ajouter ou supprimer des paramètres d’une entrée de rôle, vous devez utiliser les paramètres AddParameter ou RemoveParameter . Si vous omettez le paramètre AddParameter ou RemoveParameter lorsque vous exécutez l’applet de commande Set-ManagementRoleEntry , seuls les paramètres que vous spécifiez à l’aide du paramètre Parameters seront inclus dans l’entrée de rôle. Tous les autres paramètres de l'entrée de rôle seront supprimés.

Souhaitez-vous rechercher les autres tâches de gestion relatives aux rôles ? Consultez la rubrique Autorisations avancées.

Ce qu'il faut savoir avant de commencer

  • Durée d'exécution estimée de chaque procédure : 5 minutes

  • Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette procédure. Pour voir les autorisations qui vous sont nécessaires, consultez Entrée « Rôles de gestion » dans la rubrique Autorisations pour la gestion des rôles.

  • Vous devez utiliser l'environnement de ligne de commande Exchange Management Shell pour effectuer ces procédures.

  • Si vous souhaitez ajouter des paramètres à une entrée de rôle, les paramètres que vous ajoutez doivent exister dans l'entrée de rôle au sein du rôle parent. Les paramètres doivent également exister dans la cmdlet que vous spécifiez.

  • Si vous souhaitez supprimer des paramètres d'une entrée de rôle, ces paramètres ne doivent pas exister dans les entrées de rôle des rôles enfants. Vous devez d'abord supprimer les paramètres des entrées de rôle des rôles enfants. À l'aide de la procédure « Utiliser l'environnement de ligne de commande Exchange Management Shell pour supprimer un ou plusieurs paramètres d'une entrée de rôle », décrite plus bas dans cette rubrique, supprimez les paramètres des entrées de rôle appartenant à tous les rôles enfants.

  • Pour des informations sur les raccourcis clavier applicables aux procédures de cette rubrique, voir Raccourcis clavier dans Exchange 2013Raccourcis clavier dans le Centre d'administration Exchange.

Conseil

Vous rencontrez des difficultés ? Demandez de l’aide en participant aux forums Exchange. Visitez les forums de Exchange Server.

Utiliser l’environnement de ligne de commande Exchange Management Shell pour ajouter un ou plusieurs paramètres à une entrée de rôle

Pour ajouter des paramètres à une entrée de rôle, spécifiez les paramètres requis à l’aide du paramètre Parameters. Vous devez ensuite spécifier le paramètre AddParameter pour indiquer que vous souhaitez effectuer une opération d’ajout.

Pour ajouter des paramètres à une entrée de rôle, utilisez la syntaxe suivante.

Set-ManagementRoleEntry <role name>\<cmdlet> -Parameters <parameter 1>, <parameter 2>, <parameter...> -AddParameter

Cet exemple ajoute les paramètres EmailAddresses et Type à l’applet de commande Set-Mailbox sur le rôle Administrateurs de destinataires.

Set-ManagementRoleEntry "Recipient Administrators\Set-Mailbox" -Parameters EmailAddresses, Type -AddParameter

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Set-ManagementRoleEntry.

Utiliser l’environnement de ligne de commande Exchange Management Shell pour supprimer un ou plusieurs paramètres d’une entrée de rôle

Pour supprimer des paramètres d’une entrée de rôle, spécifiez les paramètres requis à l’aide du paramètre Parameters. Vous devez ensuite spécifier le paramètre RemoveParameter pour indiquer que vous souhaitez effectuer une opération de suppression.

Pour supprimer des paramètres d'une entrée de rôle, utilisez la syntaxe suivante.

Set-ManagementRoleEntry <role name>\<cmdlet> -Parameters <parameter 1>, <parameter 2>, <parameter...> -RemoveParameter

Cet exemple supprime les paramètres Port, ProtocolLoggingLevel et SmartHostAuthMechanism de l’applet de commande Set-SendConnector sur le rôle Administrateurs de serveur de niveau 1.

Set-ManagementRoleEntry "Tier 1 Server Administrators\Set-SendConnector" -Parameters Port, ProtocolLoggingLevel, SmartHostAuthMechanism -RemoveParameter

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Set-ManagementRoleEntry.

Utiliser l’environnement de ligne de commande Exchange Management Shell pour supprimer tous les paramètres d’une entrée de rôle

Pour supprimer tous les paramètres d’une entrée de rôle, vous devez spécifier la valeur $Null sur le paramètre Parameters . Vous n’avez pas besoin d’inclure le paramètre RemoveParameters .

La suppression globale des paramètres dans une entrée de rôle est utile si seulement quelques paramètres doivent être disponibles dans une cmdlet et que vous souhaitez en exclure tous les autres. Si vous ne voulez pas que le rôle ait accès à une cmdlet, supprimez entièrement l'entrée associée dans le rôle et non pas simplement les paramètres. Pour plus d'informations sur la suppression d'une entrée de rôle, voir Supprimer une entrée de rôle d'un rôle.

Avertissement

Vous ne pouvez pas annuler la suppression de ces opérations. Si vous supprimez par erreur tous les paramètres d'une entrée de rôle, vous devez les ajouter à nouveau manuellement.

Pour supprimer des paramètres d'une entrée de rôle, utilisez la syntaxe suivante.

Set-ManagementRoleEntry <role name>\<cmdlet> -Parameters $Null

Cet exemple indique comment supprimer tous les paramètres de la cmdlet Set-CASMailbox du rôle Administrateurs des destinataires.

Set-ManagementRoleEntry "Recipient Administrators\Set-CASMailbox" -Parameters $Null

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Set-ManagementRoleEntry.

Utiliser l’environnement de ligne de commande Exchange Management Shell pour appliquer un ensemble spécifique de paramètres

Si vous souhaitez inclure uniquement un ensemble spécifique de paramètres dans une entrée de rôle, spécifiez seulement le paramètre Parameters. N’incluez pas les paramètres AddParameter ou RemoveParameter . Lorsque vous spécifiez uniquement le paramètre Parameters , seuls les paramètres que vous spécifiez dans la commande sont inclus dans l’entrée de rôle. Tous les autres paramètres sont supprimés.

Pour spécifier un ensemble spécifique de paramètres, utilisez la syntaxe suivante.

Set-ManagementRoleEntry <role name>\<cmdlet> -Parameters <parameter 1>, <parameter 2>, <parameter...>

Cet exemple inclut uniquement les paramètres Identity, DisplayName, MissedCallNotificationEnabled et PersonalAuthAttendantEnabled sur l’applet de commande Set-UMMailbox sur le rôle Seattle Mail Recipients.

Set-ManagementRoleEntry "Seattle Mail Recipients\Set-UMMailbox" -Parameters Identity, DisplayName, MissedCallNotificationEnabled, PersonalAutoAttendantEnabled

Pour obtenir des informations détaillées sur la syntaxe et les paramètres, voir Set-ManagementRoleEntry.