Compartir a través de

  • Artículo

New-CsNetworkSubnet

 

Última modificación del tema: 2012-03-27

Crea una nueva subred de red.

Sintaxis

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>]]

Descripción detallada

Cada subred debe estar asociada con un sitio de red a fin de determinar la ubicación geográfica del host al que pertenece esta subred. Use este cmdlet para crear una nueva subred y al mismo tiempo (de forma opcional) asignarla a un sitio de red.

En la mayoría de las implementaciones de Microsoft Lync Server 2010 que implementen el control de admisión de llamadas (CAC), normalmente habrá una gran cantidad de subredes. Por ello, generalmente es mejor llamar a New-CsNetworkSubnet junto con el Windows PowerShell cmdlet Import-CSV. Usando estos cmdlets juntos, puede leer la configuración de subred en un archivo de valores separados por comas (CSV) y crear varias subredes al mismo tiempo. Para obtener información detallada, consulte la sección de Ejemplos acerca de este cmdlet.

Quiénes pueden ejecutar este cmdlet: De manera predeterminada, los miembros de los siguientes grupos están autorizados para ejecutar el cmdlet New-CsNetworkSubnet en 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 "New-CsNetworkSubnet"}

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Requerido

XdsGlobalRelativeIdentity

Id. único de la subred que se está creando. Debe ser una dirección IP (como 174.11.12.0) y debe estar ubicada en primer lugar en el intervalo de direcciones IP definido por la subred.

MaskBits

Requerido

Int32

La máscara de bits que se aplicará a la subred que se está creando.

Valores válidos: de 1 a 32

SubnetID

Requerido

Cadena de caracteres

Este es el mismo valor que el parámetro Identity. Debe especificar un valor para Identity o uno para SubnetID, pero no puede especificar ambos parámetros. Cualquier valor que proporcione para uno de ellos se aplicará automáticamente al otro.

Description

Opcional

Cadena de caracteres

Descripción de la subred que se está creando.

NetworkSiteID

Opcional

Cadena de caracteres

El Id. del sitio al cual pertenece la subred. Para recuperar los Id. de sitio de la implementación llame 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.

InMemory

Opcional

Parámetro modificador

Crea una referencia de objeto sin confirmar realmente el objeto como cambio permanente. Si se asigna la salida de este cmdlet llamado con este parámetro en una variable, puede realizar cambios en las propiedades de la referencia del objeto y después confirmar estos cambios, llamando a este conjunto coincidente de cmdlet, - cmdlet.

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

Ninguno.

Tipos de valores devueltos

Crea un objeto de tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.SubnetType.

Ejemplo

-------------------------- Ejemplo 1 --------------------------

New-CsNetworkSubnet -Identity 172.11.15.0 -MaskBits 24 -NetworkSiteID Vancouver

Este ejemplo demuestra cómo crear una nuevo objeto de subred que representa la subred 172.11.15.0/24. El parámetro Identity de la subred está definido en 172.11.15.0. Este valor se asignará automáticamente como SubnetID. Una subred debe tener definidos bits de máscara. Esto se hace al proporcionar un valor (en este caso 24) al parámetro MaskBits. Finalmente, se pasa el Id. de sitio Vancouver al parámetro NetworkSiteID para asociar esta subred a dicho sitio.

-------------------------- Ejemplo 2 --------------------------

Import-CSV C:\subnet.csv | foreach {New-CsNetworkSubnet -Identity $_.Identity -MaskBits $_.Mask -NetworkSiteID $_.SiteID}

En el Ejemplo 2 se lee un archivo CSV para crear una serie de subredes. El archivo CSV de este ejemplo tiene un aspecto similar a:

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

...

En este ejemplo, primero se llama al cmdlet Import-CSV y se pasa la ruta de acceso al archivo CSV. Este cmdlet leerá el contenido de dicho archivo en memoria. Dicho contenido se transferirá luego a la función foreach. La función foreach procesa una iteración en el contenido, una línea a la vez. Como se ve en el archivo de ejemplo, la primera línea es una lista de encabezados que definen el resto del contenido; la función foreach usará estos encabezados para obtener acceso a los valores separados por coma según su nombre.

Dentro de la instrucción foreach se llama al cmdlet New-CsNetworkSubnet. A medida que foreach procesa una iteración en cada línea del contenido del archivo, dicha línea se pasa como los valores de los parámetros New-CsNetworkSubnet. Por ejemplo, la primera vez en la instrucción foreach, New-CsNetworkSubnet creará una subred cuyo parámetro Identity será 172.11.12.0: este es el valor de la posición Identity para la primera línea de valores separados por coma. ($_ indica el valor actual del bucle foreach). Luego, el valor Mask (24) se pasa al parámetro MaskBits y el valor SiteID (Redmond) del archivo se pasa al parámetro NetworkSiteID.

Este proceso continúa hasta que se han leído todas las líneas del archivo y sus valores se han usado para crear nuevas subredes.