New-CsNetworkSubnet
上一次修改主题： 2012-03-27
创建新的网络子网。
语法
New-CsNetworkSubnet -Identity <XdsGlobalRelativeIdentity> -MaskBits <Int32> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]
New-CsNetworkSubnet -MaskBits <Int32> -SubnetID <String> [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]
详细说明
每个子网都必须与一个网络站点关联，以便确定此子网所属主机的地理位置。使用此 cmdlet 可创建新的子网，同时（可选）将其分配给某个网络站点。
在大多数实现呼叫允许控制 (CAC) 的 Microsoft Lync Server 2010 部署中，通常都将有大量子网。因此，一般最好将 New-CsNetworkSubnet 与 Windows PowerShell cmdlet Import-CSV 一起调用。通过将这些 cmdlet 配合使用，可以从逗号分隔值 (CSV) 文件读入子网设置，并且一次创建多个子网。有关详细信息，请参阅此 cmdlet 的“示例”部分。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 New-CsNetworkSubnet cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsNetworkSubnet"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 全局相关标识 |
要创建的子网的唯一子网 ID。其必须为 IP 地址（如 174.11.12.0），并且必须为子网所定义的 IP 地址范围中的第一个地址。 |
MaskBits |
必需 |
Int32 |
要应用于所创建的子网的位掩码。 有效值：1 到 32 |
SubnetID |
必需 |
字符串 |
此值与 Identity 相同。必须指定 Identity 或 SubnetID，但不能同时指定二者。向其中一个参数提供的任何值都将自动应用于另一个参数。 |
Description |
可选 |
字符串 |
所创建的子网的描述。 |
NetworkSiteID |
可选 |
字符串 |
此子网所属站点的站点 ID。通过调用 Get-CsNetworkSite cmdlet，可以检索部署的站点 ID。 |
Force |
可选 |
开关参数 |
禁止显示任何本该在进行更改前显示的确认提示。 |
InMemory |
可选 |
开关参数 |
创建对象引用，但并不作为永久性更改实际提交对象。如果将使用此参数调用的 cmdlet 的输出分配给一个变量，您可以更改对象引用的属性，然后通过调用与此 cmdlet 匹配的 Set- cmdlet 提交这些更改。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
无。
返回类型
创建一个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType 的对象。
示例
-------------------------- 示例 1 --------------------------
New-CsNetworkSubnet -Identity 172.11.15.0 -MaskBits 24 -NetworkSiteID Vancouver
此示例介绍如何创建表示子网 172.11.15.0/24 的新子网对象。该子网的 Identity 设置为 172.11.15.0。将自动分配此值作为 SubnetID。必须为子网定义掩码位。这一点是通过向 MaskBits 参数提供值（本例中为 24）实现的。最后，将站点 ID Vancouver 传递给 NetworkSiteID 参数以将此子网与该站点关联。
-------------------------- 示例 2 --------------------------
Import-CSV C:\subnet.csv | foreach {New-CsNetworkSubnet -Identity $_.Identity -MaskBits $_.Mask -NetworkSiteID $_.SiteID}
示例 2 读取 CSV 文件以创建一系列子网。此示例中的 CSV 文件类似于这种形式：
Identity, Mask, SiteID
172.11.12.0, 24, Redmond
172.11.13.0, 24, Chicago
172.11.14.0, 25, Vancouver
172.11.15.0, 31, Paris
...
此示例首先调用 Import-CSV cmdlet，然后向其传递某个 CSV 文件的路径。此 cmdlet 将该文件的内容读入内存中。然后，将这些文件内容通过管道传递给 foreach 函数。foreach 函数一次一行地循环访问这些内容。如示例文件所示，第一行是一个标题列表，用于定义其余内容；foreach 函数将使用这些标题按名称访问逗号分隔的值。
foreach 语句内调用 New-CsNetworkSubnet。在 foreach 循环访问文件内容的每一行后，将传递该行作为 New-CsNetworkSubnet 参数的值。例如，第一次运行 foreach 语句时，New-CsNetworkSubnet 将创建 Identity 为 172.11.12.0 的子网：这是第一行逗号分隔值中 Identity 位置的值。（$_ 指示 foreach 循环中当前的值。）然后，将掩码值 (24) 传递给 MaskBits 参数，并将文件中的 SiteID 值 (Redmond) 传递给 NetworkSiteID 参数。
此过程持续到读取文件中的所有行并使用其值创建新子网为止。