Set-CsNetworkSubnet
Última modificación del tema: 2012-03-26
Modifica una subred de red existente.
Sintaxis
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>]]
Descripción detallada
Cada subred debe estar asociada a un sitio de red a fin de determinar la ubicación geográfica del host que pertenece a esta subred. Use este cmdlet para modificar el sitio de red asociado, cambiar la descripción de la subred o modificar los bits de máscara de la subred.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los grupos siguientes están autorizados a ejecutar el cmdlet Set-CsNetworkSubnet de forma local: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsNetworkSubnet"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Opcional |
XdsGlobalRelativeIdentity |
El identificador de subred único de la subred que desea modificar. Este valor será una dirección IP (por ejemplo, 174.11.12.0) o una URL que comience con http: o https:. |
Instance |
Opcional |
SubnetType |
Referencia a un objeto de subred de red que desea modificar. Este objeto debe ser de tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType, que se puede recuperar al llamar a Get-CsNetworkSubnet. |
Description |
Opcional |
Cadena de caracteres |
Descripción de la subred que se modifica. |
MaskBits |
Opcional |
Int32 |
La máscara de bits que se aplicará a la subred. |
NetworkSiteID |
Opcional |
Cadena de caracteres |
El identificador del sitio correspondiente al sitio de red en que se aplicará esta subred. Puede recuperar los Id. de sitio de la implementación llamando al cmdlet Get-CsNetworkSite. |
Force |
Opcional |
Parámetro modificador |
Suprime las solicitudes de confirmación que, de lo contrario, se mostrarían antes de realizar cambios. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Objeto Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType. Acepta entradas canalizadas de los objetos de la subred de red.
Tipos de valores devueltos
Este cmdlet no devuelve un valor. Modifica un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsNetworkSubnet -Identity 172.11.15.0 -MaskBits 25 -NetworkSiteID Chicago
En este ejemplo, se modifica la subred con identidad (identificador de subred) 172.11.15.0. La subred se modifica con un nuevo valor de MaskBits (25) y un nuevo NetworkSiteID (Chicago).
-------------------------- Ejemplo 2 --------------------------
Get-CsNetworkSubnet | Where-Object {$_.NetworkSiteID -eq "Vancouver"} | Set-CsNetworkSubnet -NetworkSiteID Chicago
En el Ejemplo 2, se mueven todas las subredes del sitio de Vancouver al sitio de Chicago. Para ello, comenzamos con la llamada del cmdlet Get-CsNetworkSubnet. Se recuperará una recopilación de todas las subredes definidas en la implementación de Microsoft Lync Server 2010. Dicha recopilación de subredes después se canaliza al cmdlet Where-Object. Where-Object filtra la recopilación para obtener únicamente las subredes con NetworkSiteID igual a (-eq) Vancouver. Ahora que la recopilación solo se compone de subredes asociadas con el sitio de Vancouver, canalizamos la recopilación a Set-CsNetworkSubnet. Suministramos un parámetro a Set-CsNetworkSubnet: NetworkSiteID. Al pasar el parámetro al valor de Chicago, le indicamos a Set-CsNetworkSubnet que cambie el identificador del sitio de red de cada miembro de la recopilación a Chicago.