Add-ManagementRoleEntry

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

L'entrée de rôle que vous souhaitez ajouter doit exister dans le rôle parent. Si le nom de l'entrée de rôle contient des espaces, vous devez le mettre entre guillemets ('').

Le commutateur Remplacer entraîne le remplacement des entrées de rôle existantes par les entrées de rôle ajoutées. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Le paramètre Parameters spécifie les paramètres à inclure dans le rôle ajouté. Les paramètres spécifiés doivent exister sur la cmdlet associée à l'entrée du rôle. Vous pouvez spécifier plusieurs paramètres séparés par des virgules.

Le paramètre ParentRoleEntry spécifie l'entrée de rôle dans le rôle parent à ajouter au rôle spécifié avec le paramètre Role. En général, ce paramètre n'est pas utilisé directement, mais il permet d'activer la canalisation des entrées de rôle à partir de la cmdlet Get-ManagementRoleEntry. Si vous utilisez le paramètre ParentRoleEntry , vous ne pouvez pas utiliser le commutateur UnScopedTopLevel.

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

Le paramètre PSSnapinName spécifie le composant logiciel enfichable Windows PowerShell qui contient l’applet de commande associée au rôle ajouté. Utilisez l’applet de commande Get-PSSnapin pour récupérer la liste des composants logiciels enfichables Windows PowerShell disponibles.

Le paramètre Role spécifie le rôle auquel la nouvelle entrée de rôle, spécifiée par le paramètre ParentRoleEntry, est ajoutée.

Le paramètre Type spécifie le type de l'entrée de rôle ajoutée. Les valeurs valides sont Cmdlet, Script et ApplicationPermission.

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 vous ajoutez l’entrée de rôle à un rôle de gestion 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.

Vous ne pouvez pas utiliser ce commutateur avec le paramètre ParentRoleEntry.

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.