Set-OrganizationRelationship

Модуль:

ExchangePowerShell

Применяется к:

Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

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

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

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

Синтаксис

Set-OrganizationRelationship
   [-Identity] <OrganizationRelationshipIdParameter>
   [-ArchiveAccessEnabled <Boolean>]
   [-Confirm]
   [-DeliveryReportEnabled <Boolean>]
   [-DomainController <Fqdn>]
   [-DomainNames <MultiValuedProperty>]
   [-Enabled <Boolean>]
   [-Force]
   [-FreeBusyAccessEnabled <Boolean>]
   [-FreeBusyAccessLevel <FreeBusyAccessLevel>]
   [-FreeBusyAccessScope <GroupIdParameter>]
   [-MailboxMoveCapability <MailboxMoveCapability>]
   [-MailboxMoveEnabled <Boolean>]
   [-MailboxMovePublishedScopes <MultiValuedProperty>]
   [-MailTipsAccessEnabled <Boolean>]
   [-MailTipsAccessLevel <MailTipsAccessLevel>]
   [-MailTipsAccessScope <GroupIdParameter>]
   [-Name <String>]
   [-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

Set-OrganizationRelationship -Identity "Fourth Coffee" -FreeBusyAccessLevel LimitedDetails

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

Пример 2

Set-OrganizationRelationship -Identity "Contoso" -Enabled $false

В этом примере отключается организационная связь с Contoso

Параметры

-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").

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

-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

-Force

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

Этот параметр можно применять для программного выполнения задач, не требующего вмешательства администратора.

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

-Identity

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

• Имя
• каноническое имя;
• GUID

Type:	OrganizationRelationshipIdParameter
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, 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,...ValueN. Если значения содержат пробелы или иным образом требуют кавычек, используйте следующий синтаксис: "Value1","Value2",..."ValueN".

Чтобы добавить или удалить одно или несколько значений, не затрагивая существующие записи, используйте следующий синтаксис: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

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

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

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

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

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