Set-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 Set-ManagementRoleEntry permet de modifier les paramètres disponibles sur une entrée de rôle de gestion existante.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntax
Set-ManagementRoleEntry
[-Identity] <RoleEntryIdParameter>
[-AddParameter]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-Parameters <String[]>]
[-RemoveParameter]
[-UnScopedTopLevel]
[-WhatIf]
[<CommonParameters>] Description
La cmdlet Set-ManagementRoleEntry modifie les paramètres existants sur une entrée de rôle existante. Si vous souhaitez ajouter des paramètres à une entrée de rôle, les paramètres doivent exister dans l'entrée de rôle au sein du rôle de gestion parent. Si vous souhaitez supprimer des paramètres à partir d'une entrée de rôle, il est possible que les rôles enfants qui héritent de ces paramètres à partir de l'entrée de rôle à modifier ne contiennent aucune entrée de rôle. Vous ne pouvez pas modifier des entrées de rôle associées à des rôles intégrés.
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
Set-ManagementRoleEntry "Help Desk Personnel\Get-Mailbox" -Parameters "Anr","Database" -RemoveParameterCet exemple supprime les paramètres Anr et Database de l'entrée de rôle Get-Mailbox sur le rôle Help Desk Personnel.
Exemple 2
Get-ManagementRoleEntry "Help Desk Personnel\*" | Set-ManagementRoleEntry -Parameters WhatIf -AddParameterCet exemple récupère une liste d'entrées de rôle sur le rôle Help Desk Personnel et ajoute le commutateur WhatIf à chaque entrée de rôle, à l'aide de la cmdlet Set-ManagementRoleEntry.
Exemple 3
Set-ManagementRoleEntry "Tier 1 Help Desk\Set-Mailbox" -Parameters "DisplayName","ForwardingAddress"Cet exemple ajoute les paramètres DisplayName et ForwardingAddress à l'entrée de rôle Set-Mailbox sur le rôle Tier 1 Help Desk, tandis que tous les autres paramètres sont supprimés de l'entrée de rôle.
Exemple 4
Set-ManagementRoleEntry "IT Scripts\MailboxAudit" -Parameters Location -AddParameter -UnScopedTopLevelDans Exchange local, cet exemple ajoute le paramètre Location au script personnalisé MailboxAudit sur le rôle de niveau supérieur non défini 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
-AddParameter
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.
| 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 |
-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 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 ("").
| 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 |
-Parameters
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.
| 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 |
-RemoveParameter
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.
| 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 |
-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 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.
| 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.