Compartir a través de

  • Artículo

New-CsServerApplication

 

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

Crea una nueva aplicación de servidores. Las aplicaciones de servidores son aplicaciones hospedadas por Microsoft Lync Server 2010.

Sintaxis

New-CsServerApplication -Identity <XdsIdentity> -Uri <String> [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-ScriptName <String>] [-WhatIf [<SwitchParameter>]]

New-CsServerApplication -Name <String> -Parent <String> -Uri <String> [-Confirm [<SwitchParameter>]] [-Critical <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-Priority <Int32>] [-ScriptName <String>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Las aplicaciones de servidor son los programas individuales que se ejecutan en Microsoft Lync Server 2010. El cmdlet New-CsServerApplication proporciona a los administradores una manera de configurar nuevas aplicaciones de servidores.

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

Parámetros

Parámetro Requerido Tipo Descripción

Identity

Opcional

Identidad Xds

Identificador único de la aplicación de servidores que se creará. Las identidades de aplicaciones de servidores se componen del servicio donde se aloja la aplicación más el nombre de la aplicación. Por ejemplo, la aplicación de servicios denominada QoEAgent podría tener una identidad similar a la siguiente: service:Registrar:atl-cs-001.litwareinc.com/QoEAgent.

Parent

Requerido

Cadena de caracteres

Especifica el servicio que alojará a la nueva aplicación de servidores. Si usa el parámetro Identity, no necesitará usar los parámetros Parent o Name; eso ocurre porque la identidad de la aplicación combina los valores de las propiedades Parent y Name. Sin embargo, puede omitir el parámetro Identity al usar los parámetros Parent y Name, en su lugar. En ese caso, el parámetro Parent necesitaría verse de la siguiente manera: -Parent "Registrar:atl-cs-001.litwareinc.com".

Name

Requerido

Cadena de caracteres

Nombre descriptivo del servicio. Si usa el parámetro Identity, no necesita incluir el parámetro Name al crear un nuevo servicio; en cambio, la propiedad Name se rellenará con la parte del nombre de la aplicación Identity. Por ejemplo, si crea una nueva aplicación con Identity service:Registrar:atl-cs-001.litwareinc.com/TestService, la aplicación automáticamente se denominará TestService. El parámetro Name solo es necesario si usa el parámetro Parent.

Uri

Requerido

Cadena de caracteres

Identificador uniforme de recursos (URI) único de la aplicación. Por ejemplo, la aplicación QoEAgent tiene el URI https://www.microsoft.com/LCS/QoEAgent.

Enabled

Opcional

Booleano

Configure este valor en True para habilitar la aplicación. Establece el valor en False para deshabilitar la aplicación. Si este parámetro no se especifica, la propiedad Enabled se establecerá en False y la nueva aplicación se desactivará.

Critical

Opcional

Booleano

Si se establece en True, Lync Server no se iniciará, a menos que la aplicación en cuestión se pueda iniciar. Si es False, Lync Server se iniciará independientemente de que la aplicación se pueda iniciar. Si este parámetro no se especifica, la propiedad Critical se establecerá en True.

ScriptName

Opcional

Cadena de caracteres

Ruta del script Microsoft SIP Processing Language (MSPL) usado por la aplicación (si corresponde). MSPL es un lenguaje de scripting que se usa para filtrar y enrutar mensajes SIP.

Priority

Opcional

Entero

Indica el orden de ejecución de aplicaciones de servidores. En primer lugar, comienza con la aplicación con prioridad 0; en segundo lugar, comienza con la aplicación con prioridad 1; etc. Recuerde que cada servicio que hospeda una aplicación de servidores tiene su propio conjunto de prioridades únicas. Por ejemplo, el servicio registrador puede hospedar tres aplicaciones con sus correspondientes prioridades 0, 1 y 2. De igual manera, el servicio de Servidor perimetral puede tener cuatro aplicaciones. Estas aplicaciones tendrán las prioridades 0, 1, 2 y 3.

Si no especifica una prioridad, la aplicación se agregará automáticamente al final de la lista de prioridades. Si agrega o quita una aplicación, las prioridades de las otras aplicaciones se ajustarán como corresponda. Por ejemplo, si suprime una aplicación con prioridad 0, entonces la aplicación que anteriormente tenía prioridad 1 se configurará automáticamente con prioridad 0.

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.

Force

Opcional

Parámetro modificador

Suprime la visualización de los mensajes de error que no sean graves y que puedan producirse al ejecutar el comando.

WhatIf

Opcional

Parámetro modificador

Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente.

Confirm

Opcional

Solicita confirmación antes de ejecutar el comando.

Tipos de entrada

Ninguno. New-CsServerApplication no acepta entradas canalizadas.

Tipos de valores devueltos

New-CsServerApplication crea nuevas instancias del objeto Microsoft.Rtc.Management.WritableConfig.Settings.ServerApplication.Application.

Ejemplo

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

New-CsServerApplication -Identity "EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor" -Uri http://www.litwareinc.com/edgemonitor -Critical $False

En el ejemplo 1 se crea una nueva aplicación de servidor con Identity EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor. Además de especificar la identidad, se incluyen los parámetros Uri y Critical; estos parámetros se usan para especificar la aplicación URI y para indicar que la aplicación no es considerada crítica.

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

$x = New-CsServerApplication -Identity "EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor" -InMemory
$x.Uri = "http://www.litwareinc.com/edgemonitor"
$x.Critical = $False
Set-CsServerApplication -Instance $x

Los comandos que se muestran en el Ejemplo 2 demuestran la manera en que puede crear una nueva aplicación de servidores que inicialmente existen solo en la memoria. Para ello, el primer comando llama a New-CsServerApplication junto con dos parámetros: Identity (que especifica la identidad de la aplicación) e InMemory, que indica que la nueva aplicación solo se debe crear en la memoria. Luego, el objeto resultante de la aplicación del servidor se almacena en la variable $x.

Después de la creación de esta aplicación de servidor virtual, se usan los comandos 2 y 3 para modificar los valores de las propiedades Uri y Critical, respectivamente. Finalmente, el comando 4 se usa para transformar la aplicación del servidor virtual en una aplicación de servidor real. Recuerde que este comando final es obligatorio. Si no llama a Set-CsServerApplication, no se configurará ninguna aplicación para EdgeServer:atl-edge-001.litwareinc.com/EdgeMonitor, y la aplicación virtual desaparecerá tan pronto como finalice su sesión de Windows PowerShell o elimine la variable $x.