Remove-ManagementRole

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 ExampleRole1

In questo esempio viene rimosso il solo ruolo ExampleRole1.

Esempio 2

Remove-ManagementRole ExampleRole2 -Recurse -WhatIf

In 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 -WhatIf

In 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" -UnScopedTopLevel

In 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

-DomainController

-Force

-Identity

-Recurse

-UnScopedTopLevel

-WhatIf

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.