New-SharingPolicy

  • 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 New-SharingPolicy para crear una directiva de uso compartido para regular el modo en que los usuarios que hay dentro de la organización comparten la información de calendario y contactos con los usuarios que hay fuera de la organización. Los usuarios solo pueden compartir esta información una vez configurada la federación en Exchange. Una vez configurada la federación, los usuarios pueden enviar invitaciones de uso compartido que cumplan con una directiva de uso compartido a destinatarios externos de otras organizaciones Exchange Server 2010 o posteriores que tengan habilitada la federación. Debe asignarse una directiva de uso compartido a un buzón para que sea efectivo. Si un buzón de correo no tiene asignada una directiva específica de uso compartido, se aplica una directiva predeterminada al nivel de uso compartido que se permite para este buzón de correo.

Compartir directivas permite el uso compartido establecido por los usuarios de persona a persona tanto de la información del calendario, como la de contacto con diferentes tipos de usuarios externos. Las directivas de uso compartido permiten a los usuarios compartir su información de contacto y disponibilidad (incluidas las carpetas Calendario y Contactos) con destinatarios de otras organizaciones federadas de Exchange externas. Para destinatarios que no se encuentran en una organización federada externa o que pertenecen a organizaciones que no son de Exchange, las directivas de uso compartido permiten el uso compartido entre personas de información de calendario con usuarios anónimos mediante la publicación de calendarios de Internet.

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

New-SharingPolicy
   [-Name] <String>
   -Domains <MultiValuedProperty>
   [-Confirm]
   [-Default]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-WhatIf]
   [<CommonParameters>]

Description

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

New-SharingPolicy -Name "Contoso" -Domains 'mail.contoso.com: CalendarSharingFreeBusyDetail, ContactsSharing'

En este ejemplo se crea la directiva de uso compartido Contoso para el dominio contoso.com, que es un dominio externo a la organización. Esta directiva permite a los usuarios del dominio contoso.com ver la información detallada de disponibilidad y de contactos. Esta directiva está habilitada de modo predeterminado.

Ejemplo 2

New-SharingPolicy -Name "SharingPolicy01" -Domains 'mail.contoso.com: CalendarSharingFreeBusySimple', 'mail.fabrikam.com: CalendarSharingFreeBusySimple' -Enabled $false -Default $true

En este ejemplo se crea una directiva de uso compartido predeterminada, que se aplica a todos los buzones que no tienen asignada ninguna directiva de uso compartido de forma implícita. Esta directiva de uso compartido SharingPolicy01 se aplica a dos dominios diferentes, y la directiva de uso compartido se ha deshabilitado.

Parámetros

-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

-Default

El conmutador Default especifica que esta directiva de uso compartido es la directiva de uso compartido predeterminada para todos los buzones con mensajes. No es necesario especificar un valor con este modificador.

Si no se aplicó ninguna directiva de uso compartido a un buzón con mensajes, automáticamente se aplicará la directiva predeterminada. Si desea deshabilitar el uso compartido en su organización, puede configurar la directiva predeterminada como deshabilitada.

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

-Domains

El parámetro Domains especifica los dominios y las opciones de uso compartido asociadas para esos dominios en la directiva de uso compartido. Los valores de este parámetro usan la sintaxis básica: 'Domain: SharingPolicyAction'.

Puede usar los siguientes valores para Domain:

  • Un dominio: por ejemplo, mail.contoso.com. Un dominio no incluye subdominios. Es necesario configurar cada subdominio por separado.
  • *: Compartir con organizaciones federadas externas. Por ejemplo, otra organización de Microsoft 365 o una organización de Exchange local.
  • Anónimo: comparta con organizaciones externas y no federadas e individuos con acceso a Internet.

Puede usar los siguientes valores para SharingPolicyAction:

  • CalendarSharingFreeBusySimple: Compartir solo horas de disponibilidad
  • CalendarSharingFreeBusyDetail: Compartir horas de disponibilidad, asunto y ubicación
  • CalendarSharingFreeBusyReviewer: Compartir horas de disponibilidad, asunto, ubicación y el cuerpo del mensaje o elemento de calendario
  • ContactsSharing: compartir solo contactos

Puede especificar varios 'Domain: SharingPolicyAction' valores separados por comas y puede especificar varios SharingPolicyAction valores para el mismo dominio separados por comas. Por ejemplo, 'mail.contoso.com: CalendarSharingFreeBusySimple', 'mail.fabrikam.com: CalendarSharingFreeBusyDetail, ContactsSharing'.

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

-Enabled

El parámetro Enabled especifica si se habilitará la nueva directiva de uso compartido. La entrada válida para este parámetro es $true o $false. El valor predeterminado es $true.

Cuando la directiva de uso compartido está deshabilitada, los usuarios configurados para usar esta directiva siguen compartiendo información hasta que el asistente de directivas de uso compartido ejecute y elimine los permisos en la carpeta compartida. La frecuencia con la que se ejecuta el asistente de de directivas de uso compartido se asigna en el cmdlet Set-MailboxServer usando el parámetro SharingPolicySchedule.

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

-Name

El parámetro Name especifica el nombre de la nueva directiva de uso compartido.

Type:String
Position:1
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.