Add-ManagementRoleEntry
Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. 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 Syntaxe da la cmdlet Exchange.
Syntax
Add-ManagementRoleEntry
[-Identity] <RoleEntryIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-Overwrite]
[-Parameters <String[]>]
[-PSSnapinName <String>]
[-Type <ManagementRoleEntryType>]
[-UnScopedTopLevel]
[-WhatIf]
[<CommonParameters>] Add-ManagementRoleEntry
[-ParentRoleEntry] <RoleEntryIdParameter>
-Role <RoleIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-Overwrite]
[-WhatIf]
[<CommonParameters>] Description
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.
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 de rôle de gestion, consultez Présentation des rôles de gestion.
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, 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 rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.
Exemples
Exemple 1
Add-ManagementRoleEntry "Recipient Administrators\Get-Mailbox"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.
Exemple 2
Add-ManagementRoleEntry "Recipient Administrators\Get-Mailbox" -Parameters "Identity","Anr","Server","Filter"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.
Exemple 3
Get-ManagementRoleEntry "Mail Recipients\*Mailbox*" | Add-ManagementRoleEntry -Role "Mailbox Administrators"Cet exemple utilise l’applet de commande Get-ManagementRoleEntry pour récupérer la liste de toutes les entrées de rôle qui existent sur le rôle de gestion Des destinataires du courrier contenant la chaîne « Mailbox » dans le nom de l’applet de commande, puis les ajoute au rôle Administrateurs de boîtes aux lettres à l’aide de l’applet de commande 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.
Exemple 4
Add-ManagementRoleEntry "IT Scripts\MailboxAudit" -Parameters "Department","Location" -UnScopedTopLevelDans Exchange local, cet exemple ajoute le script MailboxAudit avec les paramètres Department et Location au rôle de niveau supérieur non spécifié Scripts informatiques. Notez que le commutateur UnScopedTopLevel nécessite le rôle Gestion des rôles unscope, qui n’est affecté à aucun groupe de rôles par défaut.
Paramètres
-Confirm
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.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-DomainController
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 ».
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Force
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Identity
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 ('').
| Type: | RoleEntryIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Overwrite
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Parameters
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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-ParentRoleEntry
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.
| Type: | RoleEntryIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PSSnapinName
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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Role
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.
| Type: | RoleIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Type
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.
| Type: | ManagementRoleEntryType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-UnScopedTopLevel
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
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.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
Entrées
Input types
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.
Sorties
Output types
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.