Set-CsNetworkSubnet
上一次修改主题： 2012-03-26
修改现有网络子网。
语法
Set-CsNetworkSubnet [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-MaskBits <Int32>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]
Set-CsNetworkSubnet [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-MaskBits <Int32>] [-NetworkSiteID <String>] [-WhatIf [<SwitchParameter>]]
详细说明
每个子网都必须与一个网络站点关联，以便确定此子网所属主机的地理位置。使用此 cmdlet 可以修改关联网络站点、更改子网的描述，或修改子网的掩码位。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Set-CsNetworkSubnet cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsNetworkSubnet"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 全局相关标识 |
要修改的子网的唯一子网 ID。此值可以是 IP 地址（例如 174.11.12.0）或以 http: 或https: 开头的 URL。 |
Instance |
可选 |
SubnetType |
对要修改的网络子网对象的引用。此对象的类型必须为 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType，它可以通过调用 Get-CsNetworkSubnet 进行检索。 |
Description |
可选 |
字符串 |
修改的子网的描述。 |
MaskBits |
可选 |
Int32 |
要应用于子网的位掩码。 |
NetworkSiteID |
可选 |
字符串 |
此子网应用于的网络站点的站点 ID。通过调用 Get-CsNetworkSite cmdlet，可以检索部署的站点 ID。 |
Force |
可选 |
开关参数 |
禁止显示任何本该在进行更改前显示的确认提示。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType 对象。接受通过管道传递的网络子网对象的输入。
返回类型
此 cmdlet 不返回值。它会修改一个类型为 Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType 的对象。
示例
-------------------------- 示例 1 --------------------------
Set-CsNetworkSubnet -Identity 172.11.15.0 -MaskBits 25 -NetworkSiteID Chicago
此示例会对 Identity（子网 ID）为 172.11.15.0 的子网进行修改。使用新 MaskBits 值 (25) 和新 NetworkSiteID (Chicago) 修改子网。
-------------------------- 示例 2 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"} | Set-CsNetworkSubnet -NetworkSiteID Chicago
示例 2 会将 Vancouver 站点上的所有子网移动到 Chicago 站点。为此，我们首先调用 Get-CsNetworkSubnet cmdlet。这将检索在 Microsoft Lync Server 2010 部署中定义的所有子网的集合。然后将该子网集合通过管道传递到 Where-Object cmdlet。Where-Object 会接受该集合并将其范围缩小为仅包含 NetworkSiteID 等于 (-eq) Vancouver 的子网。现在，集合仅由与 Vancouver 站点关联的子网组成，我们将此集合通过管道传递到 Set-CsNetworkSubnet。向 Set-CsNetworkSubnet 提供一个参数：NetworkSiteID。通过传递参数值 Chicago，我们指示 Set-CsNetworkSubnet 将集合中每个成员的网络站点 ID 更改为 Chicago。