Add-ManagementRoleEntry

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2016-03-31

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. Certains paramètres peuvent être propres à un environnement ou à un autre.

La cmdlet Add-ManagementRoleEntry permet d'ajouter des entrées de rôle de gestion à un rôle de gestion existant.

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

Add-ManagementRoleEntry -Identity <RoleEntryIdParameter> [-Parameters <String[]>] [-PSSnapinName <String>] [-Type <Cmdlet | Script | ApplicationPermission | WebService | All>] [-UnScopedTopLevel <SwitchParameter>] <COMMON PARAMETERS>

Add-ManagementRoleEntry -ParentRoleEntry <RoleEntryIdParameter> -Role <RoleIdParameter> <COMMON PARAMETERS>

COMMON PARAMETERS: [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-Overwrite <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Cet exemple ajoute une nouvelle entrée de rôle pour la cmdlet Get-Mailbox au rôle de gestion Administrateurs des destinataires. L'entrée de rôle pour la cmdlet Get-Mailbox est ajoutée exactement comme elle est configurée dans le rôle parent Administrateurs des destinataires.

Add-ManagementRoleEntry "Recipient Administrators\Get-Mailbox"

Cet exemple ajoute une nouvelle entrée de rôle pour la cmdlet Get-Mailbox au rôle Administrateurs des destinataires. Seuls les paramètres Identity, Anr, Server et Filter sont ajoutés à la nouvelle entrée de rôle.

Add-ManagementRoleEntry "Recipient Administrators\Get-Mailbox" -Parameters Identity, Anr, Server, Filter

Cet exemple utilise la cmdlet Get-ManagementRoleEntry pour récupérer une liste de toutes les entrées de rôles qui existent sur le rôle de gestion Destinataires de message et dont le nom de cmdlet contient « Mailbox ». Puis, il ajoute ces entrées au rôle Administrateurs de boîtes aux lettres à l'aide de la cmdlet Add-ManagementRoleEntry. Les entrées de rôle sont ajoutées au rôle enfant exactement comme elles sont configurées sur le rôle parent.

Get-ManagementRoleEntry "Mail Recipients\*Mailbox*" | Add-ManagementRoleEntry -Role "Mailbox Administrators"

Cet exemple ajoute le script MailboxAudit avec les paramètres Department et Location au rôle de niveau supérieur Scripts informatiques non délimité.

Add-ManagementRoleEntry "IT Scripts\MailboxAudit" -Parameters Department, Location -UnScopedTopLevel

La cmdlet et ses paramètres que vous ajoutez à une entrée de rôle doivent exister dans le rôle parent. Vous ne pouvez pas ajouter des entrées de rôle à des rôles intégrés.

importantImportant :
Vous pouvez uniquement ajouter une entrée de rôle à un rôle de gestion si l’entrée de rôle en question existe dans le rôle parent du rôle. Par exemple, si vous tentez d’ajouter l’entrée de rôle Search-Mailbox à un rôle enfant du rôle Destinataires de message, vous recevrez un message d’erreur. Cette erreur survient parce que l’entrée de rôle Search-Mailbox n'existe pas dans le rôle Destinataires de message. Pour ajouter l’entrée de rôle Search-Mailbox à un rôle, vous devez créer un rôle enfant à partir du rôle d’importation et d’exportation de boîte aux lettres dans lequel figure l’entrée de rôle Search-Mailbox. Vous pouvez ensuite vous servir de la cmdlet Add-ManagementRoleEntry pour ajouter l’entrée de rôle Search-Mailbox au nouveau rôle enfant.

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

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour voir les autorisations qui vous sont nécessaires, voir entrée « Entrées des rôles de gestion » dans la rubrique Autorisations pour la gestion des rôles.

 

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.RoleEntryIdParameter

Le paramètre Identity spécifie l'entrée de rôle à ajouter. Vous devez spécifier la valeur du paramètre Identity en respectant le format suivant : <rôle de gestion>\<nom de l'entrée de rôle>, par exemple, RôleExemple\Set-Mailbox.

Pour plus d’informations sur le fonctionnement des entrées des rôles de gestion, voir 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 ('').

ParentRoleEntry

Obligatoire

Microsoft.Exchange.Configuration.Tasks.RoleEntryIdParameter

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.

Role

Obligatoire

Microsoft.Exchange.Configuration.Tasks.RoleIdParameter

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.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm 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 cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets 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.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 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.

Force

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre est réservé à l’usage interne chez Microsoft.

Overwrite

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Overwrite entraîne le remplacement des entrées de rôle existantes par les entrées de rôle ajoutées.

Parameters

Facultatif

System.String[]

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.

PSSnapinName

Facultatif

System.String

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

Le paramètre PSSnapinName spécifie le composant logiciel enfichable Windows PowerShell contenant la cmdlet associée au rôle ajouté. Utilisez la cmdlet Get-PSSnapin pour récupérer une liste des composants logiciels enfichables Windows PowerShell disponibles.

Type

Facultatif

Microsoft.Exchange.Data.Directory.Management.ManagementRoleEntryType

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.

UnScopedTopLevel

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur UnScopedTopLevel indique que vous ajoutez un script personnalisé ou une cmdlet non Exchange pour un rôle de gestion de niveau supérieur non délimité. Vous ne pouvez utiliser le commutateur UnScopedTopLevel que lorsque vous ajoutez une entrée de rôle à un rôle de niveau supérieur non délimité. Si vous utilisez le commutateur UnScopedTopLevel , vous ne pouvez pas utiliser le paramètre ParentRoleEntry.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

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.

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: