New-CsNetworkMediaBypassConfiguration
上一次修改主题： 2012-03-26
创建新的全局设置以便实现媒体绕过功能。
语法
New-CsNetworkMediaBypassConfiguration [-AlwaysBypass <$true | $false>] [-BypassID <String>] [-Enabled <$true | $false>] [-EnableDefaultBypassID <$true | $false>] [-ExternalBypassMode <Nullable>] [-InternalBypassMode <Nullable>]
详细说明
此 cmdlet 可创建用于实现音频连接的媒体绕过功能的全局设置。
与 Microsoft Lync Server 2010 中的大多数 New- cmdlet 不同，此 cmdlet 不会立即保存新配置，而仅在内存中创建设置。必须将此 cmdlet 创建的对象保存到变量中，然后分配给网络配置的 MediaBypassSettings 属性。（有关详细信息，请参阅本主题中的“示例”部分。）
使用此 cmdlet 创建的设置只能通过访问全局网络配置的 MediaBypassSettings 属性进行检索。要检索这些设置，请运行以下命令：(Get-CsNetworkConfiguration).MediaBypassSettings。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsNetworkMediaBypassConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkMediaBypassConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
AlwaysBypass |
可选 |
布尔值 |
如果将此参数设置为 True，则会在所有调用中尝试媒体绕过。 仅当禁用了呼叫允许控制 (CAC) 时，才应将此参数值设置为 True。仅对于符合以下条件的部署，才应将此参数设置为 True： - 不需要带宽控制。 - 不需要精确的配置以确定何时发生绕过。 - 网关与客户端之间有完全连接。 如果 Enabled 参数设置为 True 且 AlwaysBypass 设置为 False，绕过逻辑将使用网络配置站点和区域来确定何时可能发生绕过。 如果将 AlwaysBypass 设置为 True，但同时未将 Enabled 参数的值设置为 True，您将收到一条警告消息：如果将 Enabled 设置为 False，将忽略 AlwaysBypass 设置。 如果将 AlwaysBypass 和 Enabled 都设置为 True，则会自动生成一个绕过 ID，该 ID 将存储在 BypassID 属性中。 默认值：False |
BypassID |
可选 |
字符串 |
媒体绕过 ID。如果 AlwaysBypass 参数设置为 True，且为该参数提供了值，则此 BypassID 参数将与所有子网关联。如果 AlwaysBypass 为 False，则 BypassID 值将与不在网络配置站点和区域中的所有子网关联。 此 ID 必须采用 GUID 格式（如 96f14dea-5170-429a-b92b-f1cb909c4bb6）。但是，您通常不需要设置或更改此参数。当 Enabled 设置为 True 或满足以下任意条件时，将自动生成该值：1) AlwaysBypass 设置为 True，或者 2) EnableDefaultBypassID 参数设置为 True。 |
Enabled |
可选 |
布尔值 |
将此参数设置为 True 可启用媒体绕过。启用媒体绕过功能后，将根据 AlwaysBypass 设置的值做出是否绕过的决定，如下所述： - 如果 AlwaysBypass 为 True，则将对所有呼叫尝试绕过。 - 如果 AlwaysBypass 为 False，则使用网络配置站点和区域来确定绕过的可能性。 默认值：False |
EnableDefaultBypassID |
可选 |
布尔值 |
仅当 AlwaysBypass 设为 False 时，此值才适用。 如果将该值设置为 True，会自动生成一个默认绕过 ID。此自动生成的值将存储在 BypassID 属性中。 如果存在远程站点具有限定带宽链路的完美连接核心，此参数将非常有用。管理员只需要定义通过网络配置站点和区域与远程站点关联的子网。无需定义任何与此核心关联的子网，并且在这些子网之间将自动尝试绕过。 默认值：False |
ExternalBypassMode |
可选 |
BypassModeEnumType |
保留以供将来使用。Lync Server 2010 中不支持外部媒体绕过功能。 默认值：Off |
InternalBypassMode |
可选 |
BypassModeEnumType |
此参数的值控制组织从网络内部连接的客户端何时可以尝试执行媒体绕过。如果 Enabled 设置为 True，该值将自动更改为 Any。此参数的其他值保留供将来使用。 默认值：Off |
输入类型
无。
返回类型
创建一个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.MediaBypassSettingsType 的对象引用。
示例
-------------------------- 示例 1 --------------------------
$a = New-CsNetworkMediaBypassConfiguration -AlwaysBypass $true -Enabled $true
Set-CsNetworkConfiguration -MediaBypassSettings $a
此示例中的命令启用媒体绕过功能，并将其配置为始终尝试绕过。此示例中的第一行调用 New-CsNetworkMediaBypassConfiguration cmdlet。我们向此 cmdlet 传递以下两个参数：AlwaysBypass 和 Enabled，并将这两个参数同时设置为 True ($true)。将 Enabled 设置为 True 可启用媒体绕过功能，而将 AlwaysBypass 设置为 True 可确保在所有调用中尝试媒体绕过。（请注意，设置这两个参数将自动为 BypassID 属性生成一个值。）New-CsNetworkMediaBypassConfiguration 仅在内存中创建对象，因此我们将该对象分配给变量 $a。
媒体绕过配置随网络配置设置一起存储。因此，在此示例的第二行中，我们调用 Set-CsNetworkConfiguration cmdlet，并向 MediaBypassSettings 参数传递在第一行中创建的媒体绕过配置对象 ($a)，从而将媒体绕过配置更改保存到网络配置中。
-------------------------- 示例 2 --------------------------
$a = (Get-CsNetworkConfiguration).MediaBypassSettings
$a.AlwaysBypass = $false
Set-CsNetworkConfiguration -MediaBypassSettings $a
Lync Server 未提供 Set-CsNetworkMediaBypassConfiguration cmdlet，因此为了修改现有设置，必须创建新配置（如示例 1 所示）以替换现有配置，或者必须通过以下方式修改现有设置：检索并修改现有设置，然后使用 Set-CsNetworkConfiguration cmdlet 保存更改。此示例演示如何使用后一种方法来关闭 AlwaysBypass 选项。
此示例中的第一行检索现有媒体绕过设置。它通过调用 Get-CsNetworkConfiguration 来进行检索。对此 cmdlet 的调用位于括号中，以确保在运行该命令的任何其他部分之前完成此 cmdlet。Get-CsNetworkConfiguration 会检索整个网络配置的所有设置。由于我们仅关注媒体绕过设置，因此指定 MediaBypassSettings 属性以便仅检索这些设置。我们将这些设置分配给变量 $a。
在第二行中，通过为 AlwaysBypass 属性分配值 False ($false) 来修改变量 $a 中存储的设置。最后，在第三行中，我们调用 Set-CsNetworkConfiguration，并向 MediaBypassSettings 参数传递 $a 变量，从而将所做更改保存到 AlwaysBypass 属性中。