Add-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 Add-MailboxFolderPermission para agregar permisos de nivel de carpeta para los usuarios de los buzones de correo.

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

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

Description

Para modificar los permisos que se asignan al usuario en una carpeta de buzón, use el cmdlet Set-MailboxFolderPermission. Para quitar todos los permisos asignados a un usuario en una carpeta de buzón de correo, use el cmdlet Remove-MailboxFolderPermission.

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

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

En este ejemplo se concede el rol Propietario a Ed en la carpeta Marketing del buzón de Ayla.

Ejemplo 2

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

En Exchange Online, en este ejemplo se agrega Julia como delegado de calendario al buzón de Ayla, pero sin acceso a elementos privados.

Ejemplo 3

Add-MailboxFolderPermission -Identity ayla@contoso.com:\Calendar -User laura@contoso.com -AccessRights Editor -SharingPermissionFlags Delegate,CanViewPrivateItems

En Exchange Online, en este ejemplo se agrega Laura como delegado de calendario al buzón de Ayla con acceso a elementos privados.

Parámetros

-AccessRights

El parámetro AccessRights especifica los permisos que desea agregar para el usuario en la carpeta buzón.

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 dentro de 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, editar elementos, eliminar elementos ni crear elementos.
  • 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 de uso compartido al usuario al agregar permisos de calendario para ellos. 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: no tiene ningún efecto. Este es el valor predeterminado.
  • 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.

Nota: No se pueden configurar las solicitudes de entrega de reuniones dirigidas a mí ni las respuestas a las convocatorias de reunión en las que soy el organizador de la configuración de Outlook en PowerShell. Sin embargo, puede configurar la configuración mediante Exchange Web Services (EWS). Para obtener más información, vea MeetingRequestsDeliveryScope Enum.

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 quién ha concedido permiso a la carpeta de buzón de correo. Los valores válidos son entidades de seguridad habilitadas para correo (cuentas o grupos habilitados para correo que tienen identificadores de seguridad o SID que pueden tener permisos asignados). Por ejemplo:

  • Buzones de usuario
  • Usuarios de correo
  • Grupos de seguridad habilitados para correo

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.