Remove-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 Remove-ManagementRoleEntry per rimuovere voci di ruolo di gestione esistenti.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

Remove-ManagementRoleEntry
      [-Identity] <RoleEntryIdParameter>
      [-Confirm]
      [-DomainController <Fqdn>]
      [-Force]
      [-WhatIf]
      [<CommonParameters>]

Descrizione

Il cmdlet Remove-ManagementRoleEntry rimuove voci di ruolo esistente. Non è possibile, tuttavia, rimuovere voci di ruolo dai ruoli di gestione 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. 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-ManagementRoleEntry "Tier 1 Help Desk\New-Mailbox"

In questo esempio la voce del ruolo New-Mailbox viene rimossa dal ruolo Supporto tecnico di livello 1.

Esempio 2

Get-ManagementRoleEntry "Tier 1 Help Desk\*" | where {$_.Name -like 'New-*'} | foreach {Remove-ManagementRoleEntry -Identity "$($_.id)\$($_.name)"}

In questo esempio vengono rimosse tutte le voci del ruolo con il verbo Nuovo nel ruolo Help Desk di livello 1 inviando l'output del cmdlet Get-ManagementRoleEntry al cmdlet Where-Object che specifica il filtro verbo e quindi questi risultati vengono inviati tramite pipe al cmdlet Remove-ManagementRoleEntry.

In questo esempio viene forzato a confermare il comando prima di procedere (non è stato usato -Confirm:$false o -Force).

Nota: Exchange Online PowerShell richiede la sintassi complessa come descritto e lo stesso comando funziona anche in Exchange Management Shell nei server Exchange locali. Exchange Management Shell supporta una sintassi molto più semplice per lo stesso risultato, ma il comando non funziona in Exchange Online PowerShell: Get-ManagementRoleEntry "Tier 1 Help Desk\New-* | Remove-ManagementRoleEntry.

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 rimuovere. Questo parametro usa la sintassi: <management role>\<role entry name> (ad esempio, CustomRole\Set-Mailbox).

Per altre informazioni sul funzionamento delle voci dei ruoli di gestione, vedere Informazioni sui ruoli di gestione.

Se il nome della voce di ruolo contiene spazi, 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

-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.