New-OrganizationRelationship
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-OrganizationRelationship para crear relaciones de organización. Las relaciones de la organización definen la configuración que se usa con organizaciones externas de Exchange para acceder a la información de disponibilidad del calendario o para mover buzones entre servidores de Exchange locales y Exchange Online como parte de las implementaciones híbridas.
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-OrganizationRelationship
[-Name] <String>
-DomainNames <MultiValuedProperty>
[-ArchiveAccessEnabled <Boolean>]
[-Confirm]
[-DeliveryReportEnabled <Boolean>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-FreeBusyAccessEnabled <Boolean>]
[-FreeBusyAccessLevel <FreeBusyAccessLevel>]
[-FreeBusyAccessScope <GroupIdParameter>]
[-MailboxMoveCapability <MailboxMoveCapability>]
[-MailboxMoveEnabled <Boolean>]
[-MailboxMovePublishedScopes <MultiValuedProperty>]
[-MailTipsAccessEnabled <Boolean>]
[-MailTipsAccessLevel <MailTipsAccessLevel>]
[-MailTipsAccessScope <GroupIdParameter>]
[-OAuthApplicationId <String>]
[-OrganizationContact <SmtpAddress>]
[-PhotosEnabled <Boolean>]
[-TargetApplicationUri <Uri>]
[-TargetAutodiscoverEpr <Uri>]
[-TargetOwaURL <Uri>]
[-TargetSharingEpr <Uri>]
[-WhatIf]
[<CommonParameters>] Description
Antes de crear una relación de organización, debe crear una confianza de federación. Para obtener más información, vea Federación.
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
Get-FederationInformation -DomainName Contoso.com | New-OrganizationRelationship -Name "Contoso" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel LimitedDetailsEn este ejemplo se crea una relación de organización con Contoso. El nombre de dominio para conectarse es contoso.com. Se usa la siguiente configuración:
El acceso de disponibilidad está habilitado.
La organización solicitante recibe la información de la hora, el asunto y la ubicación de la organización de destino.
En este ejemplo, se intenta detectar automáticamente la información de configuración de la organización externa usando los nombres de dominio que se proporcionan en el comando Get-FederationInformation. Si usa este método para crear una relación de organización, primero debe comprobar que ha creado un identificador de la organización usando el cmdlet Set-FederationOrganizationIdentifier.
Ejemplo 2
New-OrganizationRelationship -Name "Fourth Coffee" -DomainNames "mail.fourthcoffee.com" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel AvailabilityOnly -TargetAutodiscoverEpr "https://mail.fourthcoffee.com/autodiscover/autodiscover.svc/wssecurity" -TargetApplicationUri "mail.fourthcoffee.com"En este ejemplo se crea la relación de organización con Fourth Coffee usando la siguiente configuración. En este ejemplo, se proporciona la configuración de conexión con la organización externa.
El dominio con el que se realiza la conexión es mail.fourthcoffee.com.
La dirección URL de la aplicación de los servicios Web Exchange es mail.fourthcoffee.com.
La dirección URL de detección automática es https://mail.fourthcoffee.com/autodiscover/autodiscover.svc/wssecurity.
El acceso de disponibilidad está habilitado.
La organización solicitante recibe sólo información de disponibilidad con la hora.
Parámetros
-ArchiveAccessEnabled
El parámetro ArchiveAccessEnabled especifica si la relación de la organización se ha configurado para proporcionar acceso remoto a archivos. Los valores admitidos son:
- $true: La organización externa proporciona acceso remoto a los archivos de buzón de correo.
- $false: La organización externa no proporciona acceso remoto a los archivos de buzón de correo. Este es el valor predeterminado.
| 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, Exchange Online Protection |
-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, Exchange Online Protection |
-DeliveryReportEnabled
El parámetro DeliveryReportEnabled especifica si los informes de entrega deben compartirse a través de la relación de la organización. Los valores admitidos son:
- $true: Los informes de entrega deben compartirse a través de la relación de la organización. Este valor significa que la organización ha aceptado compartir todos los informes de entrega con la organización externa y la relación de la organización debe usarse para recuperar la información del informe de entrega de la organización externa.
- $false: Los informes de entrega no deben compartirse a través de la relación de la organización. Este es el valor predeterminado.
Para que el seguimiento de mensajes funcione en un escenario de Exchange entre locales, este parámetro debe establecerse en $true en ambos lados de la relación de la organización. Si el valor de este parámetro se establece en $false en uno o ambos lados de la relación de la organización, el seguimiento de mensajes entre las organizaciones no funcionará en ninguna de las dos direcciones.
| 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, Exchange Online Protection |
-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 |
-DomainNames
El parámetro DomainNames especifica los dominios SMTP de la organización externa. Puede especificar varios dominios separados por comas (por ejemplo, "contoso.com", "northamerica.contoso.com"), limitados a 238 dominios en una solicitud.
| Type: | MultiValuedProperty |
| Position: | Named |
| 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, Exchange Online Protection |
-Enabled
El parámetro Enabled especifica si se habilita la relación de la organización. Los valores admitidos son:
- $true: la relación de la organización está habilitada. Este es el valor predeterminado.
- $false: la relación de la organización está deshabilitada. Este valor deja de compartir completamente la relación de la organización.
| 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, Exchange Online Protection |
-FreeBusyAccessEnabled
El parámetro FreeBusyAccessEnabled especifica si se debe usar la relación de organización para recuperar información de disponibilidad de la organización externa. Los valores admitidos son:
- $true: la información de disponibilidad se recupera de la organización externa.
- $false: la información de disponibilidad no se recupera de la organización externa. Este es el valor predeterminado.
Puede controlar el nivel de acceso de disponibilidad y el ámbito mediante los parámetros FreeBusyAccessLevel y FreeBusyAccessScope.
| 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, Exchange Online Protection |
-FreeBusyAccessLevel
El parámetro FreeBusyAccessLevel especifica el número máximo de detalles devueltos a la organización que realiza la solicitud. Los valores admitidos son:
- Ninguno: no hay acceso de disponibilidad.
- AvailabilityOnly: acceso de disponibilidad solo con tiempo.
- LimitedDetails: acceso de disponibilidad con tiempo, asunto y ubicación.
Este parámetro solo es significativo cuando se $true el valor del parámetro FreeBusyAccessEnabled.
| Type: | FreeBusyAccessLevel |
| 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, Exchange Online Protection |
-FreeBusyAccessScope
El parámetro FreeBusyAccessScope especifica un grupo de seguridad habilitado para correo en la organización interna que contiene usuarios cuya información de disponibilidad es accesible por una organización externa. Puede usar cualquier valor que identifique de forma exclusiva al grupo. Por ejemplo:
- Nombre
- Nombre completo (DN)
- Nombre completo (DN)
- GUID
Este parámetro solo es significativo cuando se $true el valor del parámetro FreeBusyAccessEnabled.
| Type: | GroupIdParameter |
| 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, Exchange Online Protection |
-MailboxMoveCapability
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro MailboxMoveCapability se usa en migraciones de buzones entre inquilinos. Los valores admitidos son:
- Entrada
- Salida
- RemoteInbound
- RemoteOutbound
Para obtener más información, vea Migración de buzones entre inquilinos.
| Type: | MailboxMoveCapability |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-MailboxMoveEnabled
El parámetro MailboxMoveEnabled especifica si la relación de la organización permite mover buzones hacia o desde la organización externa. Los valores admitidos son:
- $true: el buzón se mueve hacia o desde la organización externa.
- $false: el buzón se mueve hacia o desde la organización externa no se permite. Este es el valor predeterminado.
| 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, Exchange Online Protection |
-MailboxMovePublishedScopes
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro MailboxMovePublishedScopes se usa en migraciones de buzones entre inquilinos para especificar los grupos de seguridad habilitados para correo cuyos miembros pueden migrar. Puede usar cualquier valor que identifique de forma exclusiva al grupo. Por ejemplo:
- Nombre
- Nombre completo (DN)
- Nombre completo (DN)
- GUID
Para especificar varios valores, use la sintaxis siguiente: <value1>,<value2>,...<valueX>. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "<value1>","<value2>",..."<valueX>".
Para obtener más información, vea Migración de buzones entre inquilinos.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-MailTipsAccessEnabled
El parámetro MailTipsAccessEnabled especifica si las sugerencias de correo para los usuarios de esta organización se devuelven a través de esta relación de organización. Los valores admitidos son:
- $true: las sugerencias de correo para los usuarios de esta organización se devuelven a través de la relación de la organización.
- $false: las sugerencias de correo para los usuarios de esta organización no se devuelven a través de la relación de la organización. Este es el valor predeterminado.
El nivel de acceso MailTips se controla mediante el parámetro MailTipsAccessLevel.
| 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, Exchange Online Protection |
-MailTipsAccessLevel
El parámetro MailTipsAccessLevel especifica el nivel de los datos de sugerencias de correo electrónico que se comparten externamente a través de esta relación de la organización. Este parámetro puede tener los valores siguientes:
- Todos: se devuelven todas las sugerencias de correo, pero los destinatarios de la organización remota se consideran externos. Para las sugerencias de correo electrónico de respuesta automática, se devuelve el mensaje de respuesta automática externo.
- Limitado: solo se devuelven aquellas sugerencias de correo electrónico que podrían impedir un informe de no entrega (NDR) o una respuesta automática. Las sugerencias de correo electrónico personalizadas, de Gran audiencia y de Destinatario moderado no se devuelven.
- Ninguno: no se devuelven sugerencias de correo electrónico a la organización remota. Este es el valor predeterminado.
Este parámetro solo es significativo cuando se $true el valor del parámetro MailTipsAccessEnabled.
| Type: | MailTipsAccessLevel |
| 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, Exchange Online Protection |
-MailTipsAccessScope
El parámetro MailTipsAccessScope especifica un grupo de seguridad habilitado para correo en la organización interna que contiene usuarios cuya información de disponibilidad es accesible por una organización externa. Puede usar cualquier valor que identifique de forma exclusiva al grupo. Por ejemplo:
- Nombre
- Nombre completo (DN)
- Nombre completo (DN)
- GUID
El valor predeterminado está en blanco ($null), lo que significa que no se especifica ningún grupo.
Si usa este parámetro, las sugerencias de correo electrónico específicas del destinatario solo se devuelven para los destinatarios que son miembros del grupo especificado. Las sugerencias de correo electrónico especificas del destinatario son:
- Respuesta automática
- Buzón de correo lleno
- Personalizado
Si no usa este parámetro, se devuelven sugerencias de correo específicas del destinatario para todos los destinatarios de la organización.
Esta restricción sólo se aplica a buzones, usuarios de correo y contactos de correo. No se aplica a los grupos de distribución.
| Type: | GroupIdParameter |
| 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, Exchange Online Protection |
-Name
El parámetro Name especifica el nombre único de la relación de la organización. La longitud máxima es de 64 caracteres.
| 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, Exchange Online Protection |
-OAuthApplicationId
Este parámetro solo está disponible en el servicio basado en la nube.
OAuthApplicationId se usa en migraciones de buzones entre inquilinos para especificar el identificador de aplicación de la aplicación de migración de buzón de correo a la que ha consentido. Para obtener más información, vea Migración de buzones entre inquilinos.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-OrganizationContact
El parámetro OrganizationContact especifica la dirección de correo electrónico que se puede usar para ponerse en contacto con la organización externa (por ejemplo, administrator@fourthcoffee.com).
| Type: | SmtpAddress |
| 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, Exchange Online Protection |
-PhotosEnabled
El parámetro PhotosEnabled especifica si las fotos de los usuarios de la organización interna se devuelven a través de la relación de la organización. Los valores admitidos son:
- $true: las fotos de los usuarios de esta organización se devuelven a través de la relación de la organización.
- $false: las fotos de los usuarios de esta organización no se devuelven a través de la relación de la organización. Este es el valor predeterminado.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-TargetApplicationUri
El parámetro TargetApplicationUri especifica el identificador uniforme de recursos (URI) de destino de la organización externa. Exchange especifica el parámetro TargetApplicationUri al solicitar un token delegado para que la organización externa capture información de disponibilidad, por ejemplo, mail.contoso.com.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-TargetAutodiscoverEpr
El parámetro TargetAutodiscoverEpr especifica la dirección URL de detección automática de servicios web de Exchange para la organización externa, por ejemplo, https://contoso.com/autodiscover/autodiscover.svc/wssecurity. Exchange usa el servicio de detección automática para detectar automáticamente el punto de conexión de servidor de Exchange correcto que se usará para las solicitudes externas.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-TargetOwaURL
El parámetro TargetOwaURL especifica la dirección URL de Outlook en la Web (anteriormente Outlook Web App) de la organización externa definida en la relación de la organización. Se usa para Outlook en la Web redirección en un escenario de Exchange entre locales. La configuración de este atributo permite a los usuarios de la organización usar su dirección URL de Outlook en la Web actual para acceder a Outlook en la Web de la organización externa.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-TargetSharingEpr
El parámetro TargetSharingEpr especifica la dirección URL de los servicios web de Exchange de destino para la organización externa.
Si usa este parámetro, esta dirección URL siempre se usa para llegar al servidor exchange externo. La dirección URL especificada por el parámetro TargetAutodiscoverEpr no se usa para buscar el servidor exchange externo.
| Type: | Uri |
| 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, Exchange Online Protection |
-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, Exchange Online Protection |
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.