Set-AvailabilityConfig
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 某些参数和设置可能只属于一个环境或另一个环境。
使用 Set-AvailabilityConfig cmdlet 设置忙/闲信息的访问级别。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Default (默认值)
Set-AvailabilityConfig
[-AllowedTenantIds <MultiValuedProperty>]
[-Confirm]
[-DomainController <Fqdn>]
[-OrgWideAccount <SecurityPrincipalIdParameter>]
[-PerUserAccount <SecurityPrincipalIdParameter>]
[-WhatIf]
[<CommonParameters>]
说明
Set-AvailabilityConfig cmdlet 定义了两个帐户或安全组:每用户忙/闲代理帐户或组,以及组织范围的忙/闲代理帐户或组。 对于可用性代理请求,当前组织中所有可用性服务都信任这些帐户和组。
要使跨林可用性服务检索当前林中的忙/闲信息,它们必须使用指定的帐户之一、属于指定的安全组之一,或者具有指定帐户或安全组之一的用户名和密码。
在 Exchange Online中,此 cmdlet 允许更新允许使用忙/闲信息共享的租户 ID 集。
您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Set-AvailabilityConfig -PerUserAccount exchangeserversgroup@fabrikam.com
在本地 Exchange 中,此示例适用于受信任的跨林可用性服务。 如果远程林受信任,并且远程林中的每用户忙/闲代理帐户或组配置为使用服务帐户,则会将配置添加到当前林中,以授权从远程林Microsoft ActiveSync 请求。
示例 2
Set-AvailabilityConfig -OrgWideAccount orgwide@contoso.com
在本地 Exchange 中,如果远程林不受信任,则此示例非常有用。 由于此帐户用于跨林忙/闲代理帐户或组,因此请使用没有 Exchange 邮箱的用户的凭据来最大程度地减少安全漏洞。 出现提示时,键入用户名和密码。
示例 3
Set-AvailabilityConfig -AllowedTenantIds "d6b0a40e-029b-43f2-9852-f3724f68ead9","87d5bade-cefc-4067-a221-794aea71922d"
在Exchange Online中,此示例仅允许与指定的租户共享忙/闲。
参数
-AllowedTenantIds
适用:Exchange Online
此参数仅在基于云的服务中可用。
AllowedTenantIds 参数指定要与 (共享忙/闲信息的Microsoft 365 组织的租户 ID 值,例如 d6b0a40e-029b-43f2-9852-f3724f68ead9) 。 可以指定用逗号分隔的多个值。 最多允许 25 个值。
若要将所有现有租户 ID 替换为指定的值,请使用以下语法: "TenantID1","TenantID2",..."TenantID25"。
若要在不影响其他现有值的情况下添加或删除租户 ID,请使用以下语法: @{Add="TenantID1","TenantID2",...; Remove="TenantID3","TenantID4",...}。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Confirm
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:
-Confirm:$false。 - 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-DomainController
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。
参数属性
| 类型: | Fqdn |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-OrgWideAccount
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
此参数仅在本地 Exchange 中有效。
OrgWideAccount 参数指定谁有权在组织范围内发出代理可用性服务请求。 可以为此参数指定以下类型的用户或组 (安全主体) :
- 邮箱用户
- 邮件用户
- 安全组
可以使用任何能够唯一标识该用户或组的值。 例如:
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
参数属性
| 类型: | SecurityPrincipalIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-PerUserAccount
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
此参数只在本地 Exchange 中可用。
PerUserAccount 参数指定有权按用户发出代理可用性服务请求的帐户或安全组。
可以使用任何能够唯一标识该用户或组的值。 例如:
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
参数属性
| 类型: | SecurityPrincipalIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-WhatIf
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Online
WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。
输入
Input types
若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。