New-CsNetworkSite
上一次修改主题： 2012-03-27
创建新网络站点以用于呼叫允许控制 (CAC) 或增强型 911 (E9-1-1)。
语法
New-CsNetworkSite -Identity <XdsGlobalRelativeIdentity> -NetworkRegionID <String> [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationPolicy <String>] [-WhatIf [<SwitchParameter>]]
New-CsNetworkSite -NetworkRegionID <String> -NetworkSiteID <String> [-BWPolicyProfileID <String>] [-BypassID <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationPolicy <String>] [-WhatIf [<SwitchParameter>]]
详细说明
网络站点是指在部署了 CAC 或 E9-1-1 的每个区域中配置的办公室或位置。此 cmdlet 创建一个新站点，并有选择性地将其与某个区域关联。例如，可将北美网络区域与 Chicago、Redmond 和 Vancouver 之类的网络站点关联。必须为组织中的每个站点创建一个 CAC 网络站点，即使该站点没有带宽限制也应如此。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsNetworkSite cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkSite"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
XdsGlobalRelativeIdentity |
新创建的网络站点的唯一标识符。站点只能在 global 作用域创建，因此该标识符不需要指定作用域。它包含在 Microsoft Lync Server 2010 部署中所有网络站点之间唯一的字符串。 |
NetworkRegionID |
必需 |
字符串 |
与此站点关联的网络区域的标识。如果要提供 BypassID（通过自动生成或手动输入），或者网络配置的 EnableBandwidthPolicyCheck 属性为 True，则此参数必须包含值。您可以通过调用 Get-CsNetworkConfiguration cmdlet 来检索网络配置设置。 |
NetworkSiteID |
必需 |
字符串 |
该值与 Identity 相同。不能同时指定 Identity 和 NetworkSiteID；为其中一个输入的值将会自动用于二者。 |
BWPolicyProfileID |
可选 |
字符串 |
用于定义此站点的带宽限制的带宽策略配置文件的标识。您可以通过调用 Get-CsNetworkBandwidthPolicyProfile cmdlet 来检索可用配置文件的列表。 如果为此参数指定值，则还必须为 NetworkRegionID 参数指定值。 |
BypassID |
可选 |
字符串 |
全局唯一标识符 (GUID)。此 GUID 用于将网络站点映射到 CAC 或 E9-1-1 网络配置中的媒体绕过设置。（请在调用 New-CsNetworkMediaBypassConfiguration 时使用此 BypassID 值。） 如果不为此参数指定值，将会自动生成一个值，但前提是已为 NetworkRegionID 参数提供值。如果不提供 NetworkRegionID 参数，将不会生成 BypassID。您也无法为 BypassID 参数显式提供值，并且无法为 NetworkRegionID 参数提供值。 如果显式指定值，则该值必须采用 GUID 的格式（例如，3b24a047-dce6-48b2-9f20-9fbff17ed62a）。建议使用自动生成方法。如果手动输入值，您将收到确认提示，要求您确认是否不希望自动生成值。 |
Description |
可选 |
字符串 |
用于描述站点的字符串。此参数可用于说明站点用途或站点位置，与只用 Identity 表示相比，该说明更具描述性。 |
LocationPolicy |
可选 |
字符串 |
与此站点关联的位置策略的名称。位置策略为站点分配特定的 E9-1-1 设置。您可以通过调用 Get-CsLocationPolicy cmdlet 来检索位置策略列表。 |
Force |
可选 |
开关参数 |
在进行更改前取消可能另外显示的任何确认提示。 |
InMemory |
可选 |
开关参数 |
创建对象引用，但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量，您可以更改对象引用的属性，然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。
返回类型
创建一个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.DisplayNetworkSiteType 的对象。
示例
-------------------------- 示例 1 --------------------------
New-CsNetworkSite -Identity Vancouver -NetworkRegionID NorthAmerica
在此示例中，创建了一个名为 Vancouver 的新网络站点。站点名称指定为 Identity 参数的值。此外，还为 NetworkRegionID 参数指定了一个值，该参数将站点与区域（此示例中为 NorthAmerica）相关联。将自动生成 BypassID 值。建议不要手动为 BypassID 设置值。
请注意，此示例中的命令未包括 BWPolicyProfileID 参数。除非（或直到）以后使用 Set-CsNetworkSite 向此站点添加了一个值，否则此站点对媒体连接将没有带宽限制。
-------------------------- 示例 2 --------------------------
New-CsNetworkSite -Identity Paris -NetworkRegionID EMEA -BWPolicyProfileID LowBWLimits
在示例 2 中，创建一个名为 Paris 的新网络站点。站点名称指定为 Identity 参数的值。如同示例 1，也为 NetworkRegionID 指定一个值，这次指定的区域是 EMEA。再次遵循建议的方法，即允许 cmdlet 生成 BypassID。与示例 1 不同，此示例还为 BWPolicyProfileID 参数指定了一个值：LowBWLimits。与该配置文件关联的策略将用于此站点。