New-ManagementRole

Syntax

New-ManagementRole
   [-Name] <String>
   -Parent <RoleIdParameter>
   [-EnabledCmdlets <String[]>]
   [-Confirm]
   [-Description <String>]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]

New-ManagementRole
   [-Name] <String>
   [-UnScopedTopLevel]
   [-Confirm]
   [-Description <String>]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]

Description

Vous pouvez créer un rôle de gestion basé sur un rôle existant, ou vous pouvez créer un rôle inattendu vide. Si vous créez un rôle basé sur un rôle existant, vous démarrez avec les entrées de rôle de gestion présentes pour le rôle existant. Vous pouvez ensuite supprimer des entrées pour personnaliser le rôle. Si vous créez un rôle sans étendue, le rôle peut contenir des scripts ou des applets de commande personnalisés qui ne font pas partie d’Exchange.

Un rôle inattendu ne possède pas les restrictions d’étendue appliquées. Les scripts ou les applets de commande tierces incluses dans un rôle sans étendue peuvent afficher ou modifier n’importe quel objet dans le organization Exchange.

La capacité à créer un rôle de gestion inattendu n’est pas accordée par défaut. Pour créer un rôle de gestion non étendue, vous devez attribuer le rôle de gestion nommé Gestion des rôles non étendues à un groupe de rôles dont vous êtes membre. Pour plus d’informations sur la création d’un rôle de gestion non étendue, consultez Créer un rôle sans étendue.

Après avoir créé un rôle, vous pouvez modifier les entrées de rôle de gestion pour ce rôle et attribuer le rôle doté d’une étendue de gestion à un utilisateur ou un groupe universel de sécurité (USG).

Pour plus d'informations sur les rôles de gestion, voir 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

New-ManagementRole -Name "Redmond Journaling View-Only" -Parent Journaling

Get-ManagementRoleEntry "Redmond Journaling View-Only\*" | Where { $_.Name -NotLike "Get*" } | %{Remove-ManagementRoleEntry -Identity "$($_.id)\$($_.name)"}

Cet exemple crée le rôle de gestion que Journalisation Redmond-Affichage seul en fonction du rôle parent Journalisation.

Une fois le rôle créé, la cmdlet Remove-ManagementRoleEntry est utilisée avec la cmdlet Where pour supprimer la totalité des rôles de gestion inutiles pour ce rôle. Vous ne pouvez pas ajouter des entrées au rôle qui vient d’être créé car il possède déjà toutes les entrées de rôle existant dans le rôle parent Journalisation.

Pour plus d’informations sur le traitement en pipeline et la cmdlet Where, consultez les rubriques suivantes :

• À propos des pipelines
• Utilisation de la sortie de la commande

Exemple 2

New-ManagementRole -Name "In-house scripts" -UnScopedTopLevel

Dans Exchange local, cet exemple crée le rôle de gestion non étendue Scripts internes. Notez que le commutateur UnScopedTopLevel nécessite le rôle Gestion des rôles non étendues, qui n’est affecté à aucun groupe de rôles par défaut.

Paramètres

-Confirm

-Description

-DomainController

-EnabledCmdlets

-Force

-Name

-Parent

-UnScopedTopLevel

-WhatIf

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.