Add-ManagementRoleEntry
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
Utilizzare il cmdlet Add-ManagementRoleEntry per aggiungere voci del ruolo di gestione a un ruolo di gestione esistente.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Add-ManagementRoleEntry
[-Identity] <RoleEntryIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-Overwrite]
[-Parameters <String[]>]
[-PSSnapinName <String>]
[-Type <ManagementRoleEntryType>]
[-UnScopedTopLevel]
[-WhatIf]
[<CommonParameters>] Add-ManagementRoleEntry
[-ParentRoleEntry] <RoleEntryIdParameter>
-Role <RoleIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-Overwrite]
[-WhatIf]
[<CommonParameters>] Descrizione
Il cmdlet e i parametri aggiunti a una voce di ruolo devono esistere nel ruolo padre. Non è possibile aggiungere voci di ruolo ai ruoli incorporati.
È possibile aggiungere una voce di ruolo a un ruolo di gestione solo se la voce di ruolo esiste nel ruolo padre. Ad esempio, si verifica un errore se si tenta di aggiungere la voce di ruolo Search-Mailbox a un ruolo figlio del ruolo Destinatari posta. Questo errore si verifica perché la voce di ruolo Search-Mailbox non esiste nel ruolo Destinatari posta. Per aggiungere la voce di ruolo Search-Mailbox a un ruolo, è necessario creare un nuovo ruolo figlio del ruolo Esportazione/importazione cassetta postale, che contiene la voce di ruolo Search-Mailbox. Successivamente è possibile utilizzare il cmdlet Add-ManagementRoleEntry per aggiungere la voce di ruolo Search-Mailbox al nuovo ruolo figlio.
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. 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
Add-ManagementRoleEntry "Recipient Administrators\Get-Mailbox"In questo esempio viene aggiunta una nuova voce di ruolo per il cmdlet Get-Mailbox al ruolo di gestione Recipient Administrators. La voce di ruolo per il cmdlet Get-Mailbox viene aggiunta esattamente come configurata nel ruolo padre Recipient Administrators.
Esempio 2
Add-ManagementRoleEntry "Recipient Administrators\Get-Mailbox" -Parameters "Identity","Anr","Server","Filter"In questo esempio viene aggiunta una nuova voce di ruolo per il cmdlet Get-Mailbox al ruolo Recipient Administrators. Alla nuova voce di ruolo vengono aggiunti solo i parametri Identity, Anr, Server e Filter.
Esempio 3
Get-ManagementRoleEntry "Mail Recipients\*Mailbox*" | Add-ManagementRoleEntry -Role "Mailbox Administrators"In questo esempio viene utilizzato il cmdlet Get-ManagementRoleEntry per recuperare un elenco di tutte le voci di ruolo presenti nel ruolo di gestione Destinatari di posta elettronica che contengono la stringa "Mailbox" nel nome del cmdlet e quindi aggiungerle al ruolo Amministratori cassette postali usando il cmdlet Add-ManagementRoleEntry. Le voci del ruolo vengono aggiunte al ruolo figlio esattamente come sono configurate nel ruolo padre.
Esempio 4
Add-ManagementRoleEntry "IT Scripts\MailboxAudit" -Parameters "Department","Location" -UnScopedTopLevelIn Exchange locale questo esempio aggiunge lo script MailboxAudit con i parametri Department e Location al ruolo di primo livello senza ambito script IT. Si noti che l'opzione UnScopedTopLevel richiede il ruolo Gestione ruoli UnScoped, che non è assegnato ad alcun gruppo di ruoli per impostazione predefinita.
Parametri
-Confirm
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-*, hanno una pausa predefinita che impone 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 hanno una pausa predefinita. 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.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-DomainController
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.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Force
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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Identity
Il parametro Identity consente di specificare la voce di ruolo da aggiungere. 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.
La voce di ruolo che si desidera aggiungere deve esistere nel ruolo padre. Se il nome della voce di ruolo contiene spazi, è necessario racchiudere il nome tra virgolette (").
| Type: | RoleEntryIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Overwrite
L'opzione Sovrascrivi determina la sovrascrittura delle voci di ruolo esistenti da parte delle voci del ruolo aggiunte. Con questa opzione non è necessario specificare alcun valore.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Parameters
Il parametro Parameters consente di specificare i parametri da includere nel ruolo da aggiungere. I parametri specificati devono esistere nel cmdlet associato alla voce di ruolo. È possibile specificare più parametri separati da virgole.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-ParentRoleEntry
Il parametro ParentRoleEntry consente di specificare la voce di ruolo nel ruolo padre da aggiungere al ruolo specificato con il parametro Role. In genere, questo parametro non viene utilizzato direttamente, ma esiste per abilitare il piping delle voci di ruolo dal cmdlet Get-ManagementRoleEntry. Se viene utilizzato il parametro ParentRoleEntry, non è possibile utilizzare l'opzione UnScopedTopLevel.
| Type: | RoleEntryIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PSSnapinName
Questo parametro è disponibile solo in Exchange locale.
Il parametro PSSnapinName specifica lo snap-in Windows PowerShell che contiene il cmdlet associato al ruolo da aggiungere. Usare il cmdlet Get-PSSnapin per recuperare un elenco di snap-in Windows PowerShell disponibili.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Role
Il parametro Role consente di specificare il ruolo a cui viene aggiunta la nuova voce di ruolo specificata dal parametro ParentRoleEntry.
| Type: | RoleIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Type
Il parametro Type consente di specificare il tipo di voce di ruolo da aggiungere. I valori validi sono Cmdlet, Script e ApplicationPermission.
| Type: | ManagementRoleEntryType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-UnScopedTopLevel
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 si sta aggiungendo la voce del ruolo a un ruolo di gestione 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.
Non è possibile usare questa opzione con il parametro ParentRoleEntry.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
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.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
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.