Set-OrganizationRelationship
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 Set-OrganizationRelationship cmdlet 可以修改现有组织关系。 组织关系定义与外部 Exchange 组织一起使用的设置,以访问日历忙/闲信息,或在本地 Exchange 服务器和Exchange Online之间移动邮箱,作为混合部署的一部分。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
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>]
说明
您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 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
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet (例如,Remove-* cmdlet) 具有内置的暂停,该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:
-Confirm:$false
。 - 大多数其他 cmdlet (例如,New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet,指定不含值的 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 参数指定此 cmdlet 从 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 参数控制 MailTips 访问级别。
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 用于跨租户邮箱迁移,以指定你同意的邮箱迁移应用的应用程序 ID。 有关详细信息,请参阅 跨租户邮箱迁移。
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。 当请求委托令牌以检索忙/闲信息(例如,mail.contoso.com)时,Exchange 会指定 TargetApplicationUri 参数。
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 参数指定外部组织的 Exchange Web 服务的自动发现 URL, 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 参数指定组织关系中定义的外部组织以前Outlook Web App) URL 的Outlook 网页版 (。 它用于在跨界 Exchange 方案中Outlook 网页版重定向。 配置此属性后,组织中的用户可以使用其当前Outlook 网页版 URL 访问外部组织中的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 参数指定外部组织的目标 Exchange Web 服务的 URL。
如果使用此参数,则始终使用此 URL 访问外部 Exchange 服务器。 TargetAutoDiscoverEpr 参数指定的 URL 不用于查找外部 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
若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。