New-ManagementRole

Sintassi

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>]

Descrizione

È possibile creare un ruolo di gestione basato su un ruolo esistente oppure creare un ruolo senza ambito vuoto. Se si crea un ruolo basato su un ruolo esistente, iniziare con le voci del ruolo di gestione presenti nel ruolo esistente. È quindi possibile rimuovere le voci per personalizzare il ruolo. Se si crea un ruolo senza ambito, il ruolo può contenere script o cmdlet personalizzati che non fanno parte di Exchange.

In un ruolo senza ambito non viene applicata una restrizione dell'ambito. Gli script o i cmdlet di terze parti inclusi in un ruolo senza ambito possono visualizzare o modificare qualsiasi oggetto nell'organizzazione di Exchange.

La possibilità di creare un ruolo di gestione senza ambito non è concessa per impostazione predefinita. Per creare un ruolo di gestione senza ambito, è necessario assegnare il ruolo di gestione denominato Gestione ruoli senza ambito a un gruppo di ruoli di cui si è membri. Per altre informazioni su come creare un ruolo di gestione senza ambito, vedere Creare un ruolo senza ambito.

Dopo la creazione di un ruolo, è possibile modificare le voci del ruolo di gestione nel ruolo e assegnare al ruolo un ambito di gestione per un utente o un gruppo di protezione universale (USG).

Per altre informazioni sui ruoli di gestione, vedere Informazioni sui ruoli di gestione.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 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)"}

In questo esempio viene creato il ruolo di gestione Redmond Journaling View-Only basato sul ruolo padre Inserimento nel journal.

Dopo la creazione del ruolo, il cmdlet Remove-ManagementRoleEntry viene utilizzato con il cmdlet Where per rimuovere tutte le voci del ruolo di gestione non necessarie per il ruolo. Non è possibile aggiungere voci di ruolo al ruolo appena creato perché dispone già di tutte le voci di ruolo esistenti nel ruolo padre Inserimento nel journal.

Per ulteriori informazioni relative all'esecuzione del piping e al cmdlet Where, vedere i seguenti argomenti:

• Informazioni sulle pipeline
• Utilizzo dell'output del comando

Esempio 2

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

In Exchange locale questo esempio crea il ruolo di gestione senza ambito Script interni. Si noti che l'opzione UnScopedTopLevel richiede il ruolo Gestione ruoli senza ambito, che non viene assegnato ad alcun gruppo di ruoli per impostazione predefinita.

Parametri

-Confirm

-Description

-DomainController

-EnabledCmdlets

-Force

-Name

-Parent

-UnScopedTopLevel

-WhatIf

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.