Get-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 Get-ManagementRoleEntry permet de récupérer les entrées de rôle de gestion qui ont été configurées sur les rôles de gestion.

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

Get-ManagementRoleEntry -Identity <RoleEntryIdParameter> [-DomainController <Fqdn>] [-Parameters <String[]>] [-PSSnapinName <String>] [-Type <ManagementRoleEntryType[]>]

Cet exemple récupère une liste de toutes les entrées de rôle qui existent sur le rôle de gestion des règles de transport.

Get-ManagementRoleEntry "Transport Rules\*"

Cet exemple récupère une liste de toutes les écritures de rôle qui contiennent la cmdlet Get-Recipient.

Get-ManagementRoleEntry *\Get-Recipient

Cet exemple récupère l’entrée de rôle de niveau 2 Help Desk\Set-Mailbox et qui envoie la sortie de la cmdlet Get-ManagementRoleEntry vers la cmdlet Format-List. La cmdlet Format-List envoie ensuite uniquement les propriétés Name, Parameters, Role et Type de l’entrée de rôle.

Get-ManagementRoleEntry "Tier 2 Help Desk\Set-Mailbox" | Format-List Name, Parameters, Role, Type

La cmdlet Get-ManagementRoleEntry récupère les entrées de rôle qui ont été configurées sur les rôles. Vous pouvez récupérer les entrées de rôle spécifiques qui correspondent aux critères spécifiques tels que le nom de rôle, le nom de cmdlet, le nom de paramètre ou une combinaison de chacun, ou le type d’entrée de rôle ou le composant logiciel enfichable Windows PowerShell associé.

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 à récupérer. Vous devez spécifier la valeur du paramètre Identity au format <rôle de gestion>\<nom de l’entrée de rôle>, par exemple, ExampleRole\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.

Vous pouvez utiliser le caractère générique (*) au lieu du rôle, du nom de cmdlet ou des deux.

Si le nom du rôle entré contient des espaces, mettez le nom entre guillemets (« »).

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.

Parameters

Facultatif

System.String[]

Le paramètre Parameters inclut uniquement les entrées de rôle qui contiennent les paramètres spécifiés. Vous pouvez spécifier plusieurs paramètres séparés par des virgules. Vous pouvez utiliser le caractère générique (*) avec les noms de paramètres partiels pour récupérer tous les paramètres qui correspondent à la valeur que vous spécifiez.

Ce paramètre s’avère utile lorsque vous utilisez le caractère générique (*) avec la valeur spécifiée dans le paramètre Identity.

PSSnapinName

Facultatif

System.String

Le paramètre PSSnapinName spécifie le composant logiciel enfichable Windows PowerShell qui contient l’entrée de rôle à renvoyer. 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 d’entrée de rôle à renvoyer. Les valeurs valides pour le paramètre Type sont toute combinaison des paramètres suivants, séparés par des virgules : Cmdlet, Script et ApplicationPermission.

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: