Set-MailboxFolderPermission

  • Referencia
Módulo:
ExchangePowerShell
Se aplica a:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.

Use el cmdlet Set-MailboxFolderPermission para modificar los permisos de nivel de carpeta para los usuarios de los buzones de correo. Este cmdlet difiere del cmdlet Add-MailboxFolderPermission en que modifica las entradas de permisos existentes. Para configurar las opciones de publicación o de uso compartido de calendario de un buzón de modo que los usuarios externos puedan ver la información del calendario, use el cmdlet Set-MailboxCalendarFolder.

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.

Syntax

Set-MailboxFolderPermission
   [-Identity] <MailboxFolderIdParameter>
   -AccessRights <MailboxFolderAccessRight[]>
   -User <MailboxFolderUserIdParameter>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-SendNotificationToUser <Boolean>]
   [-SharingPermissionFlags <MailboxFolderPermissionFlags>]
   [-WhatIf]
   [<CommonParameters>]

Description

En Exchange Online PowerShell, si no usa los parámetros SendNotificationToUser o SharingPermissionFlags, no hay cambios en la funcionalidad del cmdlet. Por ejemplo, si el usuario es un delegado existente y cambia sus permisos a Editor sin usar los parámetros SendNotificationToUser o SharingPermissionFlags, el usuario sigue siendo un delegado. Sin embargo, si usa el parámetro SendNotificationToUser ($true o $false), el parámetro SharingPermissionFlags tiene el valor predeterminado None, que puede afectar al acceso delegado para los usuarios existentes. Por ejemplo, se cambia el permiso de un delegado existente al Editor y se usa SendNotificationToUser con el valor $true. El usuario ya no será un delegado y solo tendrá permisos de editor en la carpeta.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. 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

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Marketing -User ed@contoso.com -AccessRights Owner

En este ejemplo se sobrescriben los permisos existentes de Ed para la carpeta Marketing en el buzón de Ayla. A Ed ahora se le concede el rol Propietario en la carpeta.

Ejemplo 2

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor -SharingPermissionFlags Delegate -SendNotificationToUser $true

En Exchange Online, en este ejemplo se vuelve a enviar la invitación de uso compartido a un delegado existente sin cambiar sus permisos efectivos (Ed ya es un delegado con permisos de Editor al buzón de Ayla).

Ejemplo 3

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor -SharingPermissionFlags Delegate

En Exchange Online, en este ejemplo se quita el acceso a elementos privados para un delegado existente.

Ejemplo 4

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor -SharingPermissionFlags None

En Exchange Online, este ejemplo cambia un delegado de calendario existente al Editor.

Ejemplo 5

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor

En Exchange Online, este ejemplo cambia los permisos de un usuario existente al Editor sin cambiar su estado de delegado actual.

Ejemplo 6

Set-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User ed@contoso.com -AccessRights Editor -SendNotificationToUser $false

En Exchange Online, este ejemplo cambia los permisos de un usuario existente al Editor y quita su estado de delegado actual.

Parámetros

-AccessRights

El parámetro AccessRights especifica los permisos que desea modificar para el usuario en la carpeta buzón. Los valores que especifique reemplazan los permisos existentes para el usuario en la carpeta .

Puede especificar roles o permisos de carpeta individuales, que son combinaciones de permisos. Puede especificar varios permisos y roles separados por comas.

Están disponibles los siguientes permisos individuales:

  • Ninguno: el usuario no tiene acceso para ver o interactuar con la carpeta o su contenido.
  • CreateItems: el usuario puede crear elementos en la carpeta especificada.
  • CreateSubfolders: el usuario puede crear subcarpetas en la carpeta especificada.
  • DeleteAllItems: el usuario puede eliminar todos los elementos de la carpeta especificada.
  • DeleteOwnedItems: el usuario solo puede eliminar los elementos creados a partir de la carpeta especificada.
  • EditAllItems: el usuario puede editar todos los elementos de la carpeta especificada.
  • EditOwnedItems: el usuario solo puede editar los elementos que creó en la carpeta especificada.
  • FolderContact: el usuario es el contacto de la carpeta pública especificada.
  • FolderOwner: el usuario es el propietario de la carpeta especificada. El usuario puede ver la carpeta, moverla y crear subcarpetas. El usuario no puede leer elementos, editarlos, eliminarlos ni crearlos.
  • FolderVisible: el usuario puede ver la carpeta especificada, pero no puede leer ni editar elementos dentro de la carpeta pública especificada.
  • ReadItems: el usuario puede leer elementos dentro de la carpeta especificada.

Los roles que están disponibles, junto con los permisos que asignan, se describen en la lista siguiente:

  • Autor: CreateItems, DeleteOwnedItems, EditOwnedItems, FolderVisible, ReadItems
  • Colaborador: CreateItems, FolderVisible
  • Editor: CreateItems, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderVisible, ReadItems
  • NonEditingAuthor: CreateItems, DeleteOwnedItems, FolderVisible, ReadItems
  • Propietario: CreateItems, CreateSubfolders, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderContact, FolderOwner, FolderVisible, ReadItems
  • PublishingAuthor: CreateItems, CreateSubfolders, DeleteOwnedItems, EditOwnedItems, FolderVisible, ReadItems
  • PublishingEditor: CreateItems, CreateSubfolders, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderVisible, ReadItems
  • Revisor: FolderVisible, ReadItems

Se aplican los roles siguientes específicamente a las carpetas de calendario:

  • AvailabilityOnly: ver solo los datos de disponibilidad
  • LimitedDetails: ver los datos de disponibilidad con el sujeto y la ubicación

Cuando se aplica el rol Editor a las carpetas de calendario, los delegados pueden aceptar o rechazar reuniones seleccionando manualmente la convocatoria de reunión en el buzón. En Exchange Online, para enviar solicitudes de reunión a delegados donde puedan aceptar o rechazar reuniones, use también el parámetro SharingPermissionFlags con el valor Delegate.

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

-Confirm

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

  • Los cmdlets destructivos (por ejemplo, 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 demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
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

-DomainController

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.

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

-Identity

El parámetro Identity especifica la carpeta y el buzón de destino. La sintaxis es MailboxID:\ParentFolder[\SubFolder].

Para el valor de MailboxID, 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)

Los valores de ejemplo de este parámetro son john@contoso.com:\Calendar o John:\Inbox\Reports.

Type:MailboxFolderIdParameter
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

-SendNotificationToUser

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

El parámetro SendNotificationToUser especifica si se va a enviar una invitación para compartir al usuario al modificar sus permisos de calendario. El mensaje será una invitación de uso compartido de calendario normal que el destinatario puede aceptar. Los valores admitidos son:

  • $true: se envía una invitación para compartir.
  • $false: no se envía ninguna invitación para compartir. Este es el valor predeterminado.

Este parámetro solo se aplica a las carpetas de calendario y solo se puede usar con los siguientes valores de parámetro AccessRights:

  • AvailabilityOnly
  • LimitedDetails
  • Reviewer
  • Editor
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SharingPermissionFlags

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

El parámetro SharingPermissionFlags asigna permisos de delegado de calendario. Este parámetro solo se aplica a carpetas de calendario y solo se puede usar cuando el valor del parámetro AccessRights es Editor. Los valores admitidos son:

  • Ninguno: quita los permisos delegados y actualiza la regla de mensajes de reunión para que el usuario deje de recibir invitaciones a reuniones y respuestas para el buzón. Este es el valor predeterminado cuando se usa el parámetro SendNotificationToUser sin especificar un valor para el parámetro SharingPermissionFlags.
  • Delegado: el usuario se convierte en delegado de calendario, lo que incluye la recepción de invitaciones y respuestas a reuniones. Si no hay ningún otro delegado, este valor creará la regla de mensaje de reunión. Si hay delegados existentes, el usuario se agrega a la regla de mensajes de reunión sin cambiar el modo en que se envían los mensajes delegados.
  • CanViewPrivateItems: el usuario puede acceder a elementos privados en el calendario. Debe usar este valor con el valor Delegate.

Puede especificar distintos valores separados por comas.

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

-User

El parámetro User especifica el buzón, el usuario de correo o el grupo de seguridad habilitado para correo (entidad de seguridad) al que se concede permiso para la carpeta de buzón. Puede usar cualquier valor que identifique de forma exclusiva al usuario o al grupo. Por ejemplo:

  • Nombre
  • Alias
  • Nombre distintivo (DN)
  • Nombre distintivo (DN)
  • DN canónico
  • GUID
Type:MailboxFolderUserIdParameter
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

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

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

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.