Set-ManagementRoleEntry

Le commutateur AddParameter spécifie que vous ajoutez des paramètres à l’entrée de rôle spécifiée. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Utilisez le paramètre Parameters pour spécifier les paramètres à ajouter.

Vous ne pouvez pas utiliser le commutateur AddParameter et le commutateur RemoveParameter ensemble dans la même commande.

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

• Les applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
• La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : « dc01.contoso.com ».

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Le commutateur Force masque les messages d’avertissement ou de confirmation. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Vous pouvez utiliser ce commutateur pour exécuter des tâches par programme, lorsqu’une intervention administrative est inappropriée.

Le paramètre Identity spécifie l’entrée de rôle que vous souhaitez modifier. Ce paramètre utilise la syntaxe : <management role>\<role entry name> (par exemple, CustomRole\Set-Mailbox).

Pour plus d’informations sur le fonctionnement des entrées de rôle de gestion, consultez Présentation des rôles de gestion.

Si le nom d'entrée de rôle contient des espaces, placez-le entre guillemets ("").

Le paramètre Parameters spécifie les paramètres à ajouter ou à supprimer de l'entrée de rôle.

Ce paramètre Parameters possède les modes suivants :

• Lors d'une utilisation avec le paramètre AddParameter, les paramètres que vous spécifiez sont ajoutés à l'entrée de rôle.
• Lors d'une utilisation avec le paramètre RemoveParameter, les paramètres que vous spécifiez sont supprimés de l'entrée de rôle.
• Lorsque ni les paramètres AddParameter, ni RemoveParameter paramètres sont utilisés, seuls les paramètres que vous spécifiez sont inclus dans l'entrée de rôle. Si vous spécifiez une valeur $Null et que ni les paramètres AddParameter, ni RemoveParameter sont utilisés, tous les paramètres de l'entrée de rôle sont supprimés.

Vous pouvez spécifier plusieurs paramètres séparés par des virgules.

Le commutateur RemoveParameter spécifie que vous supprimez les paramètres de l’entrée de rôle spécifiée. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Le paramètre Parameters permet de spécifier les paramètres à supprimer.

Vous ne pouvez pas utiliser le commutateur AddParameter et le commutateur RemoveParameter ensemble dans la même commande.

Ce paramètre est disponible uniquement dans Exchange sur site.

Par défaut, ce paramètre est disponible uniquement dans le rôle Gestion des rôles non étendues, et ce rôle n’est attribué à aucun groupe de rôles. Pour utiliser ce paramètre, vous devez ajouter le rôle Gestion des rôles non étendues à un groupe de rôles (par exemple, au groupe de rôles Gestion de l’organisation). Pour plus d'informations, consultez la section relative à l'Ajouter un rôle à un groupe de rôles.

Le commutateur UnScopedTopLevel spécifie que l’entrée de rôle que vous souhaitez modifier se trouve sur un rôle de niveau supérieur non défini. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Les rôles de gestion de niveau supérieur non étendues peuvent uniquement contenir des scripts personnalisés ou des applets de commande non-Exchange. Pour plus d’informations, consultez Créer un rôle sans étendue.

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.