Remove-ManagementRole
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 Remove-ManagementRole per rimuovere i ruoli di gestione personalizzati che non sono più necessari.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Remove-ManagementRole
[-Identity] <RoleIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-Recurse]
[-UnScopedTopLevel]
[-WhatIf]
[<CommonParameters>] Descrizione
È necessario rimuovere da un ruolo tutte le assegnazioni di ruolo gestione prima di eliminarlo. Se il ruolo è padre di ruoli figlio, è necessario rimuovere i ruoli figlio prima di rimuovere il ruolo principale oppure è necessario utilizzare il parametro Recurse quando si rimuove il ruolo principale. È possibile rimuovere solo ruoli personalizzati. Ruoli incorporati, come ad esempio il ruolo di Destinatari di posta elettronica, non possono essere rimossi. Per altre informazioni su come rimuovere un ruolo personalizzato, vedere Rimuovere un ruolo.
È 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
Remove-ManagementRole ExampleRole1In questo esempio viene rimosso il solo ruolo ExampleRole1.
Esempio 2
Remove-ManagementRole ExampleRole2 -Recurse -WhatIfIn questo esempio, il cmdlet Remove-ManagementRole viene eseguito con l'opzione WhatIf. L'opzione WhatIf consente di eseguire il comando come se dovesse eseguire l'azione specificata, ma non salva nessuna modifica. Al contrario, vengono visualizzati i risultati di ciò che si verificherebbe, in modo tale da poter verificare che le azioni siano corrette.
Se i risultati sono come previsto, rimuovere l'opzione WhatIf ed eseguire di nuovo il comando per rimuovere il ruolo padre ExampleRole2 e tutti i relativi ruoli figlio.
Esempio 3
Get-ManagementRole *Example* | Remove-ManagementRole -WhatIfIn questo esempio viene utilizzato il cmdlet Get-ManagementRole per ottenere un elenco dei ruoli che contengono la stringa "Example" nel nome di ruolo e quindi viene trasmesso l'elenco al cmdlet Remove-ManagementRole. Dal momento che è specificato il parametro WhatIf, il cmdlet Remove-ManagementRole visualizza quali ruoli sarebbero stati rimossi, senza salvare alcuna modifica. Se i risultati sono quelli previsti, il comando può essere nuovamente eseguito senza l'opzione WhatIf per rimuovere i ruoli.
Esempio 4
Remove-ManagementRole "In-house scripts" -UnScopedTopLevelIn Exchange locale questo esempio rimuove il ruolo di gestione di primo livello degli script interni senza ambito. Poiché si tratta di un ruolo senza ambito di primo livello, è necessario utilizzare il parametro UnScopedTopLevel. Si noti che l'opzione UnScopedTopLevel richiede il ruolo Gestione ruoli UnScoped, che non è assegnato ad alcun gruppo di ruoli per impostazione predefinita.
Per altre informazioni sui ruoli di gestione di primo livello senza ambito, vedere Informazioni sui ruoli di gestione.
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 specifica il ruolo personalizzato da rimuovere. Se il nome del ruolo contiene spazi, racchiuderlo tra virgolette (").
| Type: | RoleIdParameter |
| 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 |
-Recurse
L'opzione Recurse rimuove il ruolo specificato e tutti i ruoli figlio del ruolo specificato. Con questa opzione non è necessario specificare alcun valore.
È consigliabile testare il comando con l'opzione WhatIf per verificare che i risultati siano corretti.
| 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 |
-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 il ruolo da rimuovere è 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.
| 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.
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per