Get-ManagementRole
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni potrebbero essere esclusivi per un ambiente o l'altro.
Utilizzare il cmdlet Get-ManagementRole per visualizzare i ruoli di gestione che sono stati creati all'interno dell'organizzazione.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
GetChildren
Get-ManagementRole
[-Identity] <RoleIdParameter>
[-GetChildren]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>]
Recurse
Get-ManagementRole
[-Identity] <RoleIdParameter>
[-Recurse]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>]
Identity
Get-ManagementRole
[[-Identity] <RoleIdParameter>]
[-Cmdlet <String>]
[-CmdletParameters <String[]>]
[-DomainController <Fqdn>]
[-RoleType <RoleType>]
[<CommonParameters>]
Script
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. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. 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
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformità & sicurezza, Exchange Online Protection
Il parametro Cmdlet restituisce un elenco di tutti i ruoli che includono il cmdlet specificato.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-CmdletParameters
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformità & sicurezza, Exchange Online Protection
Il parametro CmdletParameters restituisce un elenco di tutti i ruoli che includono il parametro o i parametri specificati. È possibile specificare più parametri separando ogni parametro con una virgola. Se si specificano più parametri, vengono restituiti solo i ruoli che includono tutti i parametri specificati.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Identity
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DomainController
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Questo parametro è disponibile solo in Exchange locale.
Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.
Proprietà dei parametri
| Tipo: | Fqdn |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-GetChildren
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformità & sicurezza, Exchange Online Protection
Il parametro GetChildren consente di recuperare un elenco di tutti i ruoli creati in base al ruolo padre specificato nel parametro Identity. Con questa opzione non è necessario specificare alcun valore.
Nei risultati vengono inclusi solo i ruoli figlio immediati del ruolo padre.
È possibile usare questa opzione solo con i parametri Identity e RoleType.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
GetChildren
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Identity
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformità & sicurezza, Exchange Online Protection
Il parametro Identity specifica il ruolo che si desidera visualizzare. Se il ruolo che si desidera visualizzare contiene spazi, racchiudere il nome tra virgolette (""). È possibile utilizzare il carattere jolly (*) e un nome di ruolo parziale per individuare più ruoli.
Proprietà dei parametri
| Tipo: | RoleIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
GetChildren
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
Recurse
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
Identity
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
Script
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Recurse
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformità & sicurezza, Exchange Online Protection
Il parametro Recurse consente di recuperare un elenco di tutti i ruoli creati in base al ruolo padre specificato nel parametro Identity. Con questa opzione non è necessario specificare alcun valore.
Il ruolo specificato nel parametro Identity, i suoi ruoli figlio e i loro relativi elementi secondari vengono restituiti.
È possibile usare questa opzione solo con i parametri Identity e RoleType.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Recurse
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-RoleType
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformità & sicurezza, Exchange Online Protection
Il parametro RoleType restituisce un elenco di ruoli che corrispondono al tipo di ruolo specificato. Per un elenco dei tipi di ruolo validi, vedere Informazioni sui ruoli di gestione.
Proprietà dei parametri
| Tipo: | RoleType |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Script
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformità & sicurezza, Exchange Online Protection
Il parametro Script restituisce un elenco di tutti i ruoli che includono lo script specificato.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Script
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ScriptParameters
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Conformità & sicurezza, Exchange Online Protection
Il parametro ScriptParameters restituisce un elenco di tutti i ruoli che includono il parametro o i parametri specificati. È possibile specificare più parametri separando ogni parametro con una virgola. Se si specificano più parametri, vengono restituiti solo i ruoli che includono tutti i parametri specificati.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
Script
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.
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.