Поделиться через

New-OrganizationRelationship

  • Ссылка
Модуль:
ExchangePowerShell
Применяется к:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Командлет New-OrganizationRelationship используется для создания связей организации. Отношения организации определяют параметры, которые используются внешними организациями Exchange для доступа к сведениям о доступности календаря или перемещения почтовых ящиков между локальными серверами Exchange и Exchange Online в рамках гибридных развертываний.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

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>]

Описание

Перед созданием организационного отношения следует создать доверие федерации. Дополнительные сведения см. в разделе Федерация.

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Get-FederationInformation -DomainName Contoso.com | New-OrganizationRelationship -Name "Contoso" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel LimitedDetails

В этом примере создается организационное отношение с компанией Contoso. Имя домена для подключения — contoso.com. Используются следующие параметры:

Доступ к сведениям о занятости разрешен.

Запрашивающая организация получает от целевой организации время, тему и сведения о расположении.

В этом примере выполняется попытка автоматического обнаружения сведений о конфигурации для внешней организации с помощью доменных имен, предоставленных в команде Get-FederationInformation. Если этот метод используется для создания организационного отношения, следует убедиться в том, что идентификатор организации создан с помощью командлета Set-FederationOrganizationIdentifier.

Пример 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"

В этом примере создается организационное отношение с организацией Fourth Coffee со следующими параметрами. Параметры подключения к внешней организации предоставляются.

Подключение осуществляется к домену mail.fourthcoffee.com.

URL-адрес приложения веб-служб Exchange — mail.fourthcoffee.com.

URL-адрес автообнаружения: https://mail.fourthcoffee.com/autodiscover/autodiscover.svc/wssecurity.

Доступ к сведениям о доступности разрешен.

Запрашивающая организация получает сведения о занятости по времени.

Параметры

-ArchiveAccessEnabled

Параметр ArchiveAccessEnabled указывает, настроено ли предоставление удаленного доступа к архиву в связи организации. Допустимые значения:

  • $true. Внешняя организация предоставляет удаленный доступ к архивам почтовых ящиков.
  • $false. Внешняя организация не предоставляет удаленный доступ к архивам почтовых ящиков. Это значение используется по умолчанию.
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

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

  • Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
  • Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
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

Параметр DeliveryReportEnabled указывает, разрешено ли передавать отчеты о доставке через связь организации. Допустимые значения:

  • $true. Отчеты о доставке должны предоставляться по отношению к организации. Это значение означает, что организация согласилась предоставить доступ ко всем отчетам о доставке внешней организации, и отношения с организацией должны использоваться для получения сведений о отчете о доставке из внешней организации.
  • $false. Отчеты о доставке не должны предоставляться в отношениях организации. Это значение по умолчанию

Чтобы отслеживание сообщений работало в сценарии с локальным exchange, для этого параметра необходимо задать значение $true на обеих сторонах отношений организации. Если хотя бы с одной стороны этому параметру будет присвоено значение $false, отслеживание сообщений между организациями не будет работать ни в одном из направлений.

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

Этот параметр доступен только в локальной среде Exchange.

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, 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

Параметр DomainNames указывает домены SMTP внешней организации. В одном запросе можно указать несколько доменов, разделенных запятыми (например, "contoso.com", "northamerica.contoso.com"), только 238 доменов.

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

Параметр Enabled указывает, следует ли включить связь организации. Допустимые значения:

  • $true: связь организации включена. Это значение используется по умолчанию.
  • $false: связь организации отключена. Это значение полностью останавливает передачу информации между организациями.
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

Параметр FreeBusyAccessEnabled указывает, необходимо ли использовать эту связь организации для получения сведений о доступности из внешней организации. Допустимые значения:

  • $true: сведения о доступности извлекаются из внешней организации.
  • $false: сведения о доступности не извлекаются из внешней организации. Это значение используется по умолчанию.

Контролировать уровень доступа к сведениям о доступности можно с помощью параметров FreeBusyAccessLevel и 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

Параметр FreeBusyAccessLevel определяет максимальный объем сведений, возвращаемых организации, которая делает запрос. Допустимые значения:

  • Нет: нет свободного или занятого доступа.
  • AvailabilityOnly: бесплатный или занятый доступ только со временем.
  • LimitedDetails: свободный и занятый доступ с учетом времени, темы и расположения.

Этот параметр имеет смысл, только когда параметру FreeBusyAccessEnabled присвоено значение $true.

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

Параметр FreeBusyAccessScope указывает поддерживающую почту группу безопасности во внутренней организации, содержащую пользователей, сведения о доступности которых доступны внешней организации. Можно использовать любое уникальное значение, идентифицирующее группу. Например:

  • имя;
  • различающееся имя (DN);
  • различающееся имя (DN);
  • GUID

Этот параметр имеет смысл, только когда параметру FreeBusyAccessEnabled присвоено значение $true.

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

Этот параметр доступен только в облачной службе.

Параметр MailboxMoveCapability используется при миграции почтовых ящиков между клиентами. Допустимые значения:

  • Входящих
  • Исходящий
  • RemoteInbound
  • RemoteOutbound

Дополнительные сведения см. в разделе Миграция почтовых ящиков между клиентами.

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

Параметр MailboxMoveEnabled указывает, разрешено ли перемещение почтовых ящиков во внешнюю организацию и из нее через связь организации. Допустимые значения:

  • $true: разрешено перемещение почтовых ящиков во внешнюю организацию или из нее.
  • $false. Перемещение почтового ящика во внешнюю организацию или из нее запрещено. Это значение используется по умолчанию.
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

Этот параметр доступен только в облачной службе.

Параметр MailboxMovePublishedScopes используется при миграции почтовых ящиков между клиентами для указания групп безопасности с поддержкой почты, члены которых разрешены для миграции. Можно использовать любое уникальное значение, идентифицирующее группу. Например:

  • имя;
  • различающееся имя (DN);
  • различающееся имя (DN);
  • GUID

Чтобы ввести несколько значений, используйте следующий синтаксис: <value1>,<value2>,...<valueX>. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "<value1>","<value2>",..."<valueX>".

Дополнительные сведения см. в разделе Миграция почтовых ящиков между клиентами.

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

Параметр MailTipsAccessEnabled указывает, возвращаются ли через эту связь организации подсказки для пользователей в этой организации. Допустимые значения:

  • $true. Подсказки для пользователей в этой организации возвращаются через отношения с организацией.
  • $false. Подсказки для пользователей в этой организации не возвращаются через отношения с организацией. Это значение используется по умолчанию.

Уровень доступа к подсказкам контролируется с помощью параметра 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

Параметр MailTipsAccessLevel указывает уровень данных подсказок, внешний доступ к которым предоставляется в рамках этой связи организации. Этот параметр может принимать следующие значения:

  • Все: возвращаются все подсказки, но получатели в удаленной организации считаются внешними. Для подсказок при автоматическом ответе возвращается внешнее сообщение автоматического ответа.
  • Ограничено. Возвращаются только подсказки, которые могут предотвратить недоставку отчета (NDR) или автоответа. Настраиваемые подсказки, подсказки о большой аудитории и управляемых получателях не возвращаются.
  • Нет: в удаленную организацию не возвращаются подсказки. Это значение используется по умолчанию.

Этот параметр имеет смысл, только когда параметру MailTipsAccessEnabled присвоено значение $true.

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

Параметр MailTipsAccessScope указывает поддерживающую почту группу безопасности во внутренней организации, содержащую пользователей, сведения о доступности которых доступны внешней организации. Можно использовать любое уникальное значение, идентифицирующее группу. Например:

  • имя;
  • различающееся имя (DN);
  • различающееся имя (DN);
  • GUID

Значение по умолчанию пусто ($null), то есть группа не указана.

Если вы используете этот параметр, специальные подсказки возвращаются только для получателей, входящих в указанную группу. К числу специальных подсказок относятся:

  • Автоматический ответ
  • Почтовый ящик полон
  • Пользовательские

Если вы не используете этот параметр, специальные подсказки возвращаются для всех получателей в организации.

Это ограничение применяется только к почтовым ящикам, пользователям почты и почтовым контактам. Оно не применяется к группам рассылки.

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

Параметр Name указывает уникальное имя связи организации. Максимальная длина: 64 символа.

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

Этот параметр доступен только в облачной службе.

OAuthApplicationId используется при миграции почтовых ящиков между арендаторами, чтобы указать идентификатор приложения для миграции почтового ящика, на которое вы согласились. Дополнительные сведения см. в разделе Миграция почтовых ящиков между клиентами.

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

Параметр OrganizationContact указывает адрес электронной почты, который можно использовать для связи с внешней организацией (например, 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

Параметр PhotosEnabled указывает, возвращаются ли через связь организации фотографии пользователей внешней организации. Допустимые значения:

  • $true. Фотографии пользователей в этой организации возвращаются через отношения с организацией.
  • $false: фотографии для пользователей в этой организации не возвращаются через отношения с организацией. Это значение используется по умолчанию.
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

Параметр TargetApplicationUri указывает целевой универсальный код ресурса (URI) внешней организации. Параметр TargetApplicationUri задается Exchange при запросе делегированного маркера внешней организации для получения сведений о доступности, например 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

Параметр TargetAutodiscoverEpr указывает URL-адрес автообнаружения веб-служб Exchange для внешней организации, например https://contoso.com/autodiscover/autodiscover.svc/wssecurity. Exchange использует службу автообнаружения для автоматического обнаружения правильной конечной точки сервера Exchange, используемой для внешних запросов.

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

Параметр TargetOwaURL указывает URL-адрес Outlook в Интернете (ранее Outlook Web App) внешней организации, определенной в связи с организацией. Он используется для перенаправления Outlook в Интернете в сценарии с локальным exchange. Настройка этого атрибута позволяет пользователям в организации использовать текущий URL-адрес Outlook в Интернете для доступа к Outlook в Интернете во внешней организации.

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

Параметр TargetSharingEpr указывает URL-адрес целевых веб-служб Exchange для внешней организации.

Если вы используете этот параметр, этот URL-адрес всегда используется для доступа к внешнему серверу Exchange Server. URL-адрес, указанный параметром TargetAutodiscoverEpr, не используется для поиска внешнего сервера Exchange Server.

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

Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.

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

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.