Remove-MailboxPermission

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

Usare il cmdlet Remove-MailboxPermission per rimuovere le autorizzazioni dalla cassetta postale di un utente o da un Exchange Server 2016, Exchange Server 2019 o Exchange Online utente di posta elettronica.

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

Sintassi

Remove-MailboxPermission
      [-Identity] <MailboxIdParameter>
      -AccessRights <MailboxRights[]>
      -User <SecurityPrincipalIdParameter>
      [-BypassMasterAccountSid]
      [-Confirm]
      [-Deny]
      [-DomainController <Fqdn>]
      [-GroupMailbox]
      [-IgnoreDefaultScope]
      [-InheritanceType <ActiveDirectorySecurityInheritance>]
      [-SoftDeletedMailbox]
      [-WhatIf]
      [<CommonParameters>]
Remove-MailboxPermission
      [[-Identity] <MailboxIdParameter>]
      -Instance <MailboxAcePresentationObject>
      [-AccessRights <MailboxRights[]>]
      [-Confirm]
      [-Deny]
      [-DomainController <Fqdn>]
      [-GroupMailbox]
      [-IgnoreDefaultScope]
      [-InheritanceType <ActiveDirectorySecurityInheritance>]
      [-User <SecurityPrincipalIdParameter>]
      [-WhatIf]
      [<CommonParameters>]
Remove-MailboxPermission
      [[-Identity] <MailboxIdParameter>]
      [-BypassMasterAccountSid]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-GroupMailbox]
      [-IgnoreDefaultScope]
      [-WhatIf]
      [<CommonParameters>]
Remove-MailboxPermission
      [-Identity] <MailboxIdParameter>
      [-ClearAutoMapping]
      [-BypassMasterAccountSid]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-IgnoreDefaultScope]
      [-WhatIf]
      [<CommonParameters>]
Remove-MailboxPermission
      [-Identity] <MailboxIdParameter>
      [-ResetDefault]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-IgnoreDefaultScope]
      [-WhatIf]
      [<CommonParameters>]

Descrizione

Il cmdlet Remove-MailboxPermission consente di rimuovere le autorizzazioni dalla cassetta postale di un utente, ad esempio rimuovendo l'accesso completo alla cassetta postale di un altro utente.

È 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-MailboxPermission -Identity "Yuuto Sasaki" -User "Pedro Pizarro" -AccessRights FullAccess -InheritanceType All

In questo esempio viene rimossa l'autorizzazione di accesso completo di Pedro Pizarro alla cassetta postale di Yuuto Sasaki.

Esempio 2

Remove-MailboxPermission -Identity "HR Project" -ClearAutoMapping

In Exchange Online questo esempio esclude il mapping automatico della cassetta postale di Progetto risorse umane in Outlook per tutti gli utenti che dispongono dell'autorizzazione accesso completo alla cassetta postale.

Parametri

-AccessRights

Il parametro AccessRights consente di specificare l'autorizzazione da rimuovere dall'utente nella cassetta postale. I valori validi sono:

  • FullAccess
  • SendAs
  • ExternalAccount
  • Deleteitem
  • ReadPermission
  • ChangePermission
  • ChangeOwner

È possibile specificare più valori separati da virgole.

Type:MailboxRights[]
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

-BypassMasterAccountSid

Questo parametro è disponibile solamente nel servizio basato su cloud.

L'opzione BypassMasterAccountSid elimina l'errore seguente: Can't remove the access control entry on the object "User" for the user account because the ACE doesn't exist on the object. non è necessario specificare un valore con questa opzione.

In genere, è necessario usare questa opzione solo in Office 365 ambienti legacy dedicati o ITAR.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ClearAutoMapping

Questo parametro funziona solo nel servizio basato sul cloud.

Il parametro ClearAutoMapping esclude la cassetta postale dalla funzionalità di mapping automatico in Microsoft Outlook. Con questa opzione non è necessario specificare alcun valore.

Il mapping automatico usa l'individuazione automatica per aggiungere automaticamente cassette postali al profilo di Outlook di un utente se l'utente dispone dell'autorizzazione accesso completo alla cassetta postale. Usare questa opzione per escludere questa cassetta postale dal mapping automatico per tutti gli utenti che dispongono dell'autorizzazione accesso completo alla cassetta postale.

Non è possibile usare questa opzione con i parametri User o AccessRights.

Nota: se si usa questa opzione in un comando Remove-MailboxPermission, ma la cassetta postale non è esclusa dal mapping automatico per un utente, rimuovere l'autorizzazione accesso completo dell'utente usando il cmdlet Remove-MailboxPermission con il parametro User. Riassegnare quindi l'autorizzazione accesso completo dell'utente per la cassetta postale usando il cmdlet Add-MailboxPermission con il parametro AutoMapping impostato sul valore $false.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-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

-Deny

L'opzione Nega specifica che le autorizzazioni che si stanno rimuovendo sono autorizzazioni negate. 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

-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

-GroupMailbox

Questo parametro è disponibile solamente nel servizio basato su cloud.

L'opzione GroupMailbox è necessaria per rimuovere le autorizzazioni da una cassetta postale del gruppo Microsoft 365. 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 Online

-Identity

Il parametro Identity consente di specificare la cassetta postale di cui si stanno rimuovendo le autorizzazioni. È possibile usare qualsiasi valore che identifichi in modo univoco la cassetta postale: ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Dominio\nomeutente
  • Indirizzo di posta elettronica
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID utente o Nome entità utente (UPN)
Type:MailboxIdParameter
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

-IgnoreDefaultScope

L'opzione IgnoreDefaultScope indica al comando di ignorare l'impostazione dell'ambito del destinatario predefinito per la sessione di Exchange PowerShell e di usare l'intera foresta come ambito. Con questa opzione non è necessario specificare alcun valore.

Questa opzione consente al comando di accedere agli oggetti active directory attualmente non disponibili nell'ambito predefinito, ma introduce anche le restrizioni seguenti:

  • Non è possibile utilizzare il parametro DomainController. Il comando utilizza automaticamente un server di catalogo globale appropriato.
  • È possibile utilizzare solo il DN per il parametro Identity. Non vengono accettate altre forme di identificazione, ad esempio alias o GUID.
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

-InheritanceType

Il parametro InheritanceType consente di specificare se le autorizzazioni devono essere ereditate dalle cartelle all'interno della cassetta postale. I valori validi sono:

  • Nessuno
  • Tutto (questo è il valore predefinito)
  • Children
  • Discendenti [sic]
  • SelfAndChildren
Type:ActiveDirectorySecurityInheritance
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

-Instance

Questo parametro è disponibile solo in Exchange locale.

Il parametro Instance consente di passare al comando l'intero oggetto per l'elaborazione. Viene utilizzato principalmente negli script in cui è necessario passare l'intero oggetto al comando.

Type:MailboxAcePresentationObject
Position:Named
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

-ResetDefault

Questo parametro funziona solo nel servizio basato sul cloud.

L'opzione ResetDefault reimposta il descrittore di sicurezza predefinito della cassetta postale. Con questa opzione non è necessario specificare alcun valore.

Le autorizzazioni per la cassetta postale vengono reimpostate in modo che solo il proprietario della cassetta postale disponga dell'autorizzazione accesso completo per la cassetta postale. I seguenti tipi di autorizzazioni non sono interessati:

  • Autorizzazioni dei destinatari (ad esempio, SendAs, SendOnBehalf e delegati).
  • Autorizzazioni per le cartelle della cassetta postale assegnati utilizzando i cmdlet MailboxFolderPermission.
  • Autorizzazioni per le cartelle delle cassette postali assegnate tramite Outlook o altri client MAPI.

Inoltre, poiché questa opzione rimuove l'autorizzazione accesso completo da altri utenti nella cassetta postale, la cassetta postale non viene più mappata automaticamente da Individuazione automatica nei profili di Outlook di altri utenti.

Non è possibile usare questa opzione con i parametri User for AccessRights.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-SoftDeletedMailbox

Questo parametro è disponibile solamente nel servizio basato su cloud.

L'opzione SoftDeletedMailbox è necessaria per rimuovere le autorizzazioni da una cassetta postale eliminata temporaneamente. Con questa opzione non è necessario specificare alcun valore.

Le cassette postali eliminate temporaneamente possono essere ancora recuperate.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-User

Il parametro User consente di specificare le cui autorizzazioni vengono rimosse dalla cassetta postale specificata. È possibile specificare i tipi seguenti di utenti o gruppi (entità di sicurezza) per questo parametro:

  • Utenti della cassetta postale
  • Utenti di posta elettronica
  • Gruppi di sicurezza

È possibile utilizzare qualsiasi valore che identifichi il gruppo o l'utente in modo univoco. Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Dominio\nomeutente
  • Indirizzo di posta elettronica
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID utente o Nome entità utente (UPN)
Type:SecurityPrincipalIdParameter
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

-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

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.