Set-MailboxFolderPermission

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 seguirá siendo delegado. Pero, 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 a editor y se usa SendNotificationToUser con el valor $true. El usuario ya no será un delegado y solo tendrá permisos de editor para 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 del Ed para la carpeta marketing del buzón de Ayla. Ed ahora tiene concedido el rol de 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 reenvía la invitación para compartir a un delegado existente sin cambiar sus permisos efectivos (Ed ya es un delegado con permisos de editor en el 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, en este ejemplo se cambia un delegado de calendario existente a 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 a 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, en este ejemplo se cambian los permisos de un usuario existente a editor y se 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 de buzón de correo. Los valores que especifique reemplazarán a los permisos existentes del 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:

  • 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 que han creado desde la carpeta especificada.
  • EditAllItems: el usuario puede editar todos los elementos de la carpeta especificada.
  • EditOwnedItems: el usuario solo puede editar los elementos que han creado 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, mover la carpeta 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 los elementos de la carpeta especificada.

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

  • Autor: CreateItems, DeleteOwnedItems, EditOwnedItems, FolderVisible, ReadItems
  • Colaborador: CreateItems, FolderVisible
  • Editor: CreateItems, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderVisible, ReadItems
  • Ninguno: FolderVisible
  • Noneditingauthorcreateitems: CreateItems, FolderVisible, ReadItems
  • Owner: CreateItems, CreateSubfolders, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderContact, FolderOwner, FolderVisible, ReadItems
  • Publishingeditorcreateitems: CreateItems, CreateSubfolders, DeleteAllItems, DeleteOwnedItems, EditAllItems, EditOwnedItems, FolderVisible, ReadItems
  • Publishingauthorcreateitems: CreateItems, CreateSubfolders, DeleteOwnedItems, 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 datos de disponibilidad con asunto y ubicación
Type:MailboxFolderAccessRight[]
Position:Named
Default value:None
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, 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. 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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Identidad

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 exclusiva al buzón. Por ejemplo:

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

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

Type:MailboxFolderIdParameter
Position:1
Default value:None
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 debe enviar una invitación para uso compartido al usuario cuando se modifican 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 uso compartido.
  • $false: no se ha enviado ninguna invitación para uso compartido. 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
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 las carpetas de calendario y solo se puede usar cuando el valor del parámetro AccessRights es editor. Los valores admitidos son:

  • None: quita los permisos delegados y actualiza la regla de mensaje de la reunión para que el usuario deje de recibir invitaciones de reunión 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 un delegado de calendario, que incluye la recepción de invitaciones de reunión y respuestas. Si no hay otros delegados, este valor creará la regla de mensaje de reunión. Si hay delegados existentes, el usuario se agrega a la regla de mensaje de la reunión sin cambiar el modo en que se envían los mensajes de delegado.
  • CanViewPrivateItems: el usuario puede acceder a elementos privados en el calendario. Debe usar este valor con el valor de delegado.

Puede especificar distintos valores separados por comas.

Type:MailboxFolderPermissionFlags
Position:Named
Default value:None
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
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
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

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

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.