Get-ManagementRole

Sintassi

Get-ManagementRole
   [-Identity] <RoleIdParameter>
   [-GetChildren]
   [-DomainController <Fqdn>]
   [-RoleType <RoleType>]
   [<CommonParameters>]

Get-ManagementRole
   [-Identity] <RoleIdParameter>
   [-Recurse]
   [-DomainController <Fqdn>]
   [-RoleType <RoleType>]
   [<CommonParameters>]

Get-ManagementRole
   [[-Identity] <RoleIdParameter>]
   [-Cmdlet <String>]
   [-CmdletParameters <String[]>]
   [-DomainController <Fqdn>]
   [-RoleType <RoleType>]
   [<CommonParameters>]

Get-ManagementRole
   [[-Identity] <RoleIdParameter>]
   [-Script <String>]
   [-ScriptParameters <String[]>]
   [-DomainController <Fqdn>]
   [-RoleType <RoleType>]
   [<CommonParameters>]

Descrizione

È possibile visualizzare i ruoli di gestione in vari modi, dall'elenco di tutti i ruoli dell'organizzazione all'elenco dei soli ruoli figlio di un ruolo padre specificato. È anche possibile visualizzare i dettagli di un ruolo specifico, eseguendo il piping dell'output del cmdlet Get-ManagementRole al cmdlet Format-List.

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

Get-ManagementRole

In questo esempio vengono elencati tutti i ruoli che sono stati creati all'interno dell'organizzazione.

Esempio 2

Get-ManagementRole "Mail Recipients" -Recurse

In questo esempio vengono elencati tutti i ruoli figlio del ruolo di gestione Destinatari di posta. Il comando esegue una query ricorsiva di tutti i ruoli figlio del ruolo padre specificato. Questa query ricorsiva trova ogni ruolo figlio dal figlio diretto dell'elemento padre all'ultimo ruolo figlio nella gerarchia. In un elenco ricorsivo, anche il ruolo padre viene restituito all'elenco.

Esempio 3

Get-ManagementRole -CmdletParameters Identity, Database

In questo esempio vengono elencati tutti i ruoli che contengono sia il parametro Identity che il parametro Database. I ruoli che contengono solo uno di questi parametri non vengono restituiti.

Esempio 4

Get-ManagementRole -RoleType UnScopedTopLevel

In questo esempio vengono elencati tutti i ruoli che hanno un tipo di UnScopedTopLevel. Questi ruoli contengono script personalizzati o cmdlet non Di Exchange.

Esempio 5

Get-ManagementRole "Transport Rules" | Format-List Name, RoleType

In questo esempio viene recuperato solo il ruolo Regole di trasporto e l'output del cmdlet Get-ManagementRole viene passato al cmdlet Format-List. Il cmdlet Format-List quindi indica solo le proprietà del ruolo Regole di trasportoName e RoleType. Per altre informazioni sul pipelining e sul cmdlet Format-List, vedere Informazioni sulle pipeline e Uso dell'output dei comandi.

Esempio 6

Get-ManagementRole "Mail Recipients" -GetChildren

In questo esempio vengono elencati i figli diretti del ruolo Destinatari di posta. Vengono restituiti solo i ruoli figlio che contengono il ruolo Destinatari di posta come rispettivo ruolo padre. Il ruolo Destinatari di posta non viene restituito all'elenco.

Parametri

-Cmdlet

-CmdletParameters

-DomainController

-GetChildren

-Identity

-Recurse

-RoleType

-Script

-ScriptParameters

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.