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

Examples

Ejemplo 1

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

En este ejemplo se concede el rol de 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 un 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 a Laura como delegado de calendario al buzón de Ayla con acceso a elementos privados.

Parameters

-AccessRights

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

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, editar elementos, eliminar o 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 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 la solicitud de confirmación con 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
-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 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 le agregan permisos de calendario. El mensaje será una invitación de uso compartido de calendario normal que el destinatario puede aceptar. Los valores válidos 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 válidos son:

  • None: no tiene efecto. Este es el valor predeterminado.
  • 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 quién tiene permiso para 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
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

Inputs

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.

Outputs

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.