Remove-MailboxPermission

Módulo:
Exchange PowerShell

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Algunos parámetros y configuraciones pueden ser exclusivos de un entorno u otro.

Use el cmdlet Remove-MailboxPermission para quitar los permisos del buzón de un usuario o de un usuario de correo Exchange Server 2016, Exchange Server 2019 o Exchange Online.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Sintaxis

AccessRights 

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

Instance 

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

Owner 

Remove-MailboxPermission
    [[-Identity] <MailboxIdParameter>]
    [-BypassMasterAccountSid]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-GroupMailbox]
    [-IgnoreDefaultScope]
    [-WhatIf]
    [<CommonParameters>]

ClearAutoMapping 

Remove-MailboxPermission
    [-Identity] <MailboxIdParameter>
    [-ClearAutoMapping]
    [-BypassMasterAccountSid]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IgnoreDefaultScope]
    [-WhatIf]
    [<CommonParameters>]

ResetDefault 

Remove-MailboxPermission
    [-Identity] <MailboxIdParameter>
    [-ResetDefault]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IgnoreDefaultScope]
    [-WhatIf]
    [<CommonParameters>]

Description

El cmdlet Remove-MailboxPermission permite quitar permisos del buzón de un usuario, por ejemplo, eliminar el acceso ilimitado al buzón de otro usuario.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que tiene asignados. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Remove-MailboxPermission -Identity "Yuuto Sasaki" -User "Pedro Pizarro" -AccessRights FullAccess -InheritanceType All

En este ejemplo se quita el permiso de acceso completo de Pedro Pizarro al buzón de Yuuto Sasaki.

Ejemplo 2

Remove-MailboxPermission -Identity "HR Project" -ClearAutoMapping

En Exchange Online, este ejemplo excluye el buzón de Project de RR. HH. de la asignación automática en Outlook para todos los usuarios que tienen permiso de acceso completo al buzón.

Parámetros

-AccessRights

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El parámetro AccessRights especifica el permiso que desea quitar del usuario en el buzón. Los valores admitidos son:

  • Acceso completo
  • SendAs
  • Cuenta externa
  • DeleteItem
  • ReadPermission
  • ChangePermission
  • ChangeOwner

Puede especificar distintos valores separados por comas.

Propiedades de parámetro

Tipo:

MailboxRights[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AccessRights
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
Instance
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-BypassMasterAccountSid

Aplicable: Exchange Online

Este parámetro solo está disponible en el servicio basado en la nube.

El modificador BypassMasterAccountSid suprime el siguiente error: Can't remove the access control entry on the object "User" for the user account because the ACE doesn't exist on the object. No es necesario especificar un valor con este modificador.

Normalmente, solo necesita usar este modificador en entornos heredados de Office 365 dedicados o ITAR.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AccessRights
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
Owner
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
ClearAutoMapping
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ClearAutoMapping

Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Este parámetro solo es funcional en el servicio basado en la nube.

El parámetro ClearAutoMapping excluye el buzón de la característica de asignación automática de Microsoft Outlook. No es necesario especificar un valor con este modificador.

La asignación automática usa la Detección automática para agregar automáticamente buzones de correo al perfil de Outlook de un usuario si este tiene permiso de acceso completo al buzón. Use este modificador para excluir este buzón de la asignación automática para todos los usuarios que tengan permiso de acceso completo al buzón.

No puede usar este modificador con los parámetros User o AccessRights.

Nota: Si usa este modificador en un comando Remove-MailboxPermission, pero el buzón de correo no está excluido de la asignación automática de un usuario, quite el permiso de acceso completo del usuario mediante el cmdlet Remove-MailboxPermission con el parámetro User. A continuación, vuelva a asignar el permiso de acceso completo del usuario al buzón mediante el cmdlet Add-MailboxPermission con el parámetro AutoMapping establecido en el valor $false.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ClearAutoMapping
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador al cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

  • Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
  • La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. Para estos cmdlets, especificar el modificador Confirm sin un valor introduce una pausa que le obliga a reconocer el comando antes de continuar.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Deny

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El modificador Denegar especifica que los permisos que va a quitar son permisos de Denegar. No es necesario especificar un valor con este modificador.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AccessRights
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
Instance
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DomainController

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Este parámetro solo está disponible en Exchange local.

El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.

Propiedades de parámetro

Tipo:Fqdn
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-GroupMailbox

Aplicable: Exchange Online

Este parámetro solo está disponible en el servicio basado en la nube.

El conmutador GroupMailbox es necesario para quitar los permisos de un buzón de grupo de Microsoft 365. No es necesario especificar un valor con este modificador.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AccessRights
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
Owner
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
Instance
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Identity

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El parámetro Identity especifica el buzón de correo del que van a quitar permisos. Puede usar cualquier valor que identifique de forma única el buzón: Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre completo (DN)
  • Dominio\Nombre de usuario
  • Dirección de correo electrónico
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuario o nombre de la entidad de seguridad de usuario (UPN)

Propiedades de parámetro

Tipo:MailboxIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AccessRights
Posición:1
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
Owner
Posición:1
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
ClearAutoMapping
Posición:1
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False
ResetDefault
Posición:1
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-IgnoreDefaultScope

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El modificador IgnoreDefaultScope indica al comando que ignore la configuración predeterminada del ámbito del destinatario para la sesión de Exchange PowerShell y que use todo el bosque como ámbito. No es necesario especificar un valor con este modificador.

Este cambio habilita el comando tenga acceso a objetos de Active Directory que no están actualmente disponibles en el ámbito predeterminado, pero también introduce las siguientes restricciones:

  • No puede usar el parámetro DomainController. El comando usa un servidor de catálogo global adecuado de forma automática.
  • Sólo puede usar el DN para el parámetro Identity. No se aceptan otras formas de identificación, como alias o GUID.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-InheritanceType

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El parámetro InheritanceType especifica los permisos que heredan las carpetas dentro del buzón. Los valores admitidos son:

  • Ninguno
  • Todos (este es el valor predeterminado)
  • Children
  • Descendientes [sic]
  • SelfAndChildren

Propiedades de parámetro

Tipo:ActiveDirectorySecurityInheritance
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AccessRights
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
Instance
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Instance

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Este parámetro solo está disponible en Exchange local.

El parámetro Instance permite pasar todo un objeto al comando para su procesamiento. Se usa principalmente en scripts donde hay que pasar un objeto completo al comando.

Propiedades de parámetro

Tipo:MailboxAcePresentationObject
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Instance
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ResetDefault

Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Este parámetro solo es funcional en el servicio basado en la nube.

El modificador ResetDefault restablece el descriptor de seguridad predeterminado del buzón. No es necesario especificar un valor con este modificador.

Los permisos del buzón se restablecen para que solo el propietario del buzón tenga permiso de acceso completo al buzón. No afecta a estos tipos de permisos:

  • Permisos de destinatarios (por ejemplo, SendAs, SendOnBehalf y delegados).
  • Permisos de carpeta de buzón de correo asignados mediante el cmdlet MailboxFolderPermission.
  • Permisos de carpeta de buzón asignados con Outlook u otros clientes MAPI.

Además, dado que este modificador quita el permiso de acceso completo de otros usuarios del buzón, la detección automática ya no asigna el buzón automáticamente a los perfiles de Outlook de otros usuarios.

No puede usar este modificador con los parámetros User for AccessRights.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Instance
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SoftDeletedMailbox

Aplicable: Exchange Online

Este parámetro solo está disponible en el servicio basado en la nube.

El modificador SoftDeletedMailbox es necesario para quitar los permisos de un buzón eliminado temporalmente. No es necesario especificar un valor con este modificador.

Los buzones de correo eliminados temporalmente son buzones de correo que se han eliminado pero que todavía se pueden recuperar.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AccessRights
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-User

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El parámetro User especifica los permisos que se quitan del buzón especificado. Puede especificar los siguientes tipos de usuarios o grupos (entidades de seguridad) para este parámetro:

  • Usuarios de buzón
  • Usuarios de correo
  • Grupos de seguridad

Para obtener los mejores resultados, se recomienda usar los siguientes valores:

  • UPN: Por ejemplo, user@contoso.com (solo usuarios).
  • Domain\SamAccountName: Por ejemplo, contoso\user.

En caso contrario, puede usar cualquier valor que identifique de forma única al usuario o grupo. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre completo (DN)
  • Dominio\Nombre de usuario
  • Dirección de correo electrónico
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuario o nombre de la entidad de seguridad de usuario (UPN)

Propiedades de parámetro

Tipo:SecurityPrincipalIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AccessRights
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False
Instance
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Aplicable: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

El modificador WhatIf muestra lo que hace el comando sin realizar ningún cambio. No es necesario especificar un valor con este modificador.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.