Modifier une entrée de rôle

S'applique à : Exchange Server 2010

Dernière rubrique modifiée : 2009-09-21

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 2010, 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.

Pour ajouter ou supprimer des paramètres dans une entrée de rôle, utilisez l’environnement de ligne de commande Exchange Management Shell.

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.

Attention :

Pour ajouter ou supprimer des paramètres dans une entrée de rôle, utilisez les paramètres AddParameter ou RemoveParameter. Si vous omettez de préciser le paramètre AddParameter ou RemoveParameter lors de l’exécution de la cmdlet Set-ManagementRoleEntry, seuls les paramètres que vous spécifiez via le paramètre Parameters sont 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 Gestion des autorisations avancées.

Conditions préalables

• 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.

Que voulez-vous faire ?

• Utiliser l’environnement de ligne de commande Exchange Management Shell pour ajouter un ou plusieurs paramètres à une entrée de rôle
• Utiliser l’environnement de ligne de commande Exchange Management Shell pour supprimer un ou plusieurs paramètres d’une entrée de rôle
• Utiliser l’environnement de ligne de commande Exchange Management Shell pour supprimer tous les paramètres d’une entrée de rôle
• Utiliser l’environnement de ligne de commande Exchange Management Shell pour appliquer un ensemble spécifique de paramètres

  Remarque :
  Vous ne pouvez pas utiliser la console de gestion EMC pour modifier une entrée de rôle.

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

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

Pour ajouter des paramètres à une entrée de rôle, spécifiez les paramètres requis à l’aide du paramètre Parameters. Indiquez ensuite le paramètre AddParameter pour préciser si vous effectuez un 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 indique comment ajouter les paramètres EmailAddresses et Type à la cmdlet Set-Mailbox du rôle Administrateurs des 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

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

Pour supprimer des paramètres d’une entrée de rôle, spécifiez les paramètres requis à l’aide du paramètre Parameters. Indiquez ensuite le paramètre RemoveParameter pour préciser si vous effectuez une 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 indique comment supprimer les paramètres Port, ProtocolLoggingLevel et SmartHostAuthMechanism de la cmdlet Set-SendConnector du 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

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

Pour supprimer tous les paramètres d’une entrée de rôle, vous devez spécifier la valeur $Null dans le paramètre Parameters. Vous n’avez pas à utiliser 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 à partir d’un rôle.

Attention :
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

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

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, uniquement les paramètres que vous spécifiez dans la commande sont inclus sur 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 indique comment inclure uniquement les paramètres Identity, DisplayName, MissedCallNotificationEnabled et PersonalAuthAttendantEnabled dans la cmdlet Set-UMMailbox du rôle Destinataires à Seattle.

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.