Set-ManagementRoleEntry
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 Set-ManagementRoleEntry per modificare i parametri disponibili su una voce ruolo di gestione esistente.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Default (Impostazione predefinita)
Set-ManagementRoleEntry
[-Identity] <RoleEntryIdParameter>
[-AddParameter]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-Parameters <String[]>]
[-RemoveParameter]
[-UnScopedTopLevel]
[-WhatIf]
[<CommonParameters>]
Descrizione
Il cmdlet Set-ManagementRoleEntry modifica i parametri disponibili su una voce esistente di ruolo. Se si desidera aggiungere parametri a una voce di ruolo, questi devono essere presenti nella voce ruolo nel ruolo di gestione padre. Se si desidera rimuovere i parametri da una voce di ruolo, non ci posso essere voci di ruolo in ruoli figlio che ereditano tali parametri dalla voce di ruolo che si desidera modificare. Non è possibile modificare le voci di ruolo associate a ruoli incorporati.
Per altre informazioni sulle voci dei 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
Set-ManagementRoleEntry "Help Desk Personnel\Get-Mailbox" -Parameters "Anr","Database" -RemoveParameter
In questo esempio vengono rimossi i parametri Anr e Database dalla voce di ruolo Get-Mailbox sul ruolo Personale di assistenza tecnica.
Esempio 2
Get-ManagementRoleEntry "Help Desk Personnel\*" | Set-ManagementRoleEntry -Parameters WhatIf -AddParameter
In questo esempio viene recuperato un elenco di voci di ruolo sul ruolo del Personale di assistenza tecnica e viene aggiunta l'opzione WhatIf ad ogni voce di ruolo utilizzando il cmdlet Set-ManagementRoleEntry.
Esempio 3
Set-ManagementRoleEntry "Tier 1 Help Desk\Set-Mailbox" -Parameters "DisplayName","ForwardingAddress"
In questo esempio vengono aggiunti i parametri DisplayName e ForwardingAddress alla voce di ruolo Set-Mailbox sul ruolo di Supporto tecnico di livello 1 e vengono rimossi tutti gli altri parametri dalla voce di ruolo.
Esempio 4
Set-ManagementRoleEntry "IT Scripts\MailboxAudit" -Parameters Location -AddParameter -UnScopedTopLevel
In Exchange locale questo esempio aggiunge il parametro Location allo script personalizzato MailboxAudit nel ruolo di primo livello senza ambito script IT. L'opzione UnScopedTopLevel richiede il ruolo Gestione ruoli UnScoped, che non viene assegnato ad alcun gruppo di ruoli per impostazione predefinita.
Parametri
-AddParameter
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, componente aggiuntivo di sicurezza predefinito per l'ambiente locale Cassette postali
L'opzione AddParameter specifica che si stanno aggiungendo parametri alla voce di ruolo specificata. Con questa opzione non è necessario specificare alcun valore.
Utilizzare il parametro Parameters per specificare i parametri da aggiungere.
Non è possibile usare l'opzione AddParameter e l'opzione RemoveParameter insieme nello stesso comando.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| 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 |
-Confirm
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, componente aggiuntivo di sicurezza predefinito per l'ambiente locale Cassette postali
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.
- I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi:
-Confirm:$false. - La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non dispone di una pausa incorporata. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Cfr |
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 |
-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 |
-Force
Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per le cassette postali locali
Questo parametro è disponibile solamente nel servizio basato su cloud.
L'opzione Forza nasconde i messaggi di avviso o di conferma. Con questa opzione non è necessario specificare alcun valore.
È possibile utilizzare questa opzione per eseguire attività a livello di programmazione, se la richiesta di un input amministrativo è inappropriata.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| 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 |
-Identity
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, componente aggiuntivo di sicurezza predefinito per l'ambiente locale Cassette postali
Il parametro Identity consente di specificare la voce di ruolo da modificare. Questo parametro usa la sintassi: <management role>\<role entry name> (ad esempio, CustomRole\Set-Mailbox).
Per altre informazioni sul funzionamento delle voci del ruolo di gestione, vedere Informazioni sui ruoli di gestione.
Se il nome della voce di ruolo contiene spazi, racchiuderlo tra virgolette (").
Proprietà dei parametri
| Tipo: | RoleEntryIdParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Parameters
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, componente aggiuntivo di sicurezza predefinito per l'ambiente locale Cassette postali
Il parametro Parameters specifica i parametri da aggiungere o rimuovere dalla voce di ruolo.
Il parametro Parameters assume le seguenti modalità:
- Quando utilizzati con il parametro AddParameter, i parametri specificati vengono aggiunti alla voce di ruolo.
- Quando utilizzati con il parametro RemoveParameter, i parametri specificati vengono rimossi dalla voce di ruolo.
- Quando non viene utilizzato né il parametro AddParameter né il parametro RemoveParameter, nella voce di ruolo vengono inclusi solo i parametri specificati. Se si specifica un valore di $Null e non viene utilizzato né AddParameter né RemoveParameter, tutti i parametri della voce di ruolo vengono rimossi.
È possibile specificare più parametri separati da virgole.
Proprietà dei parametri
| Tipo: | String[] |
| 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 |
-RemoveParameter
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, componente aggiuntivo di sicurezza predefinito per l'ambiente locale Cassette postali
L'opzione RemoveParameter specifica che si stanno rimuovendo i parametri nella voce del ruolo specificata. Con questa opzione non è necessario specificare alcun valore.
Utilizzare il parametro Parameters per specificare i parametri da rimuovere.
Non è possibile usare l'opzione AddParameter e l'opzione RemoveParameter insieme nello stesso comando.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| 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 |
-UnScopedTopLevel
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Questo parametro è disponibile solo in Exchange locale.
Per impostazione predefinita, questo parametro è disponibile solo nel ruolo Gestione ruoli UnScoped e tale ruolo non è assegnato ad alcun gruppo di ruoli. Per usare questo parametro, è necessario aggiungere il ruolo Gestione ruoli UnScoped a un gruppo di ruoli, ad esempio al gruppo di ruoli Gestione organizzazione. Per ulteriori informazioni, vedere Aggiungere un ruolo a un gruppo di ruoli.
L'opzione UnScopedTopLevel specifica che la voce del ruolo da modificare si trova in un ruolo di primo livello senza ambito. Con questa opzione non è necessario specificare alcun valore.
I ruoli di gestione di primo livello senza ambito possono contenere solo script personalizzati o cmdlet non Di Exchange. Per altre informazioni, vedere Creare un ruolo senza ambito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| 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 |
-WhatIf
Applicabile: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, componente aggiuntivo di sicurezza predefinito per l'ambiente locale Cassette postali
L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
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 |
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.