Set-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 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 SyntaxeSyntaxe de cmdlet Exchange.

Set-ManagementRoleEntry -Identity <RoleEntryIdParameter> [-AddParameter <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-Parameters <String[]>] [-RemoveParameter <SwitchParameter>] [-UnScopedTopLevel <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Cet exemple supprime les paramètres Anr et Database de l'entrée de rôle Get-Mailbox sur le rôle Help Desk Personnel.

Set-ManagementRoleEntry "Help Desk Personnel\Get-Mailbox" -Parameters Anr, Database -RemoveParameter

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

Get-ManagementRoleEntry "Help Desk Personnel\*" | Set-ManagementRoleEntry -Parameters WhatIf -AddParameter

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.

Set-ManagementRoleEntry "Tier 1 Help Desk\Set-Mailbox" -Parameters DisplayName, ForwardingAddress

Cet exemple ajoute le paramètre Location au script personnalisé MailboxAudit sur le rôle de niveau supérieur non délimité IT Scripts.

Set-ManagementRoleEntry "IT Scripts\MailboxAudit" -Parameters Location -AddParameter -UnScopedTopLevel

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 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 à modifier. Vous devez spécifier la valeur du paramètre Identity au format <rôle de gestion>\<nom d'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.

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

AddParameter

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre AddParameter ajoute les paramètres spécifiés à l'entrée de rôle spécifiée. Utilisez le paramètre Parameters pour spécifier les paramètres à ajouter.Vous ne pouvez pas utiliser le paramètre AddParameter dans la même commande que le paramètre RemoveParameter.

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

Le commutateur Force spécifie s’il faut supprimer les messages d’avertissement ou de confirmation. Vous pouvez utiliser ce commutateur pour exécuter des tâches par programme, lorsqu’une intervention administrative est inappropriée. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Parameters

Facultatif

System.String[]

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.

RemoveParameter

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre RemoveParameter supprime les paramètres spécifiés de l'entrée de rôle spécifiée. Le paramètre Parameters permet de spécifier les paramètres à supprimer. Vous ne pouvez pas utiliser le paramètre RemoveParameter dans la même commande que le paramètre AddParameter.

UnScopedTopLevel

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur UnScopedTopLevel doit être utilisé lorsque vous souhaitez modifier une entrée de rôle sur un rôle de niveau supérieur non délimité.

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: