New-CsTrustedApplicationPool
Última modificación del tema: 2012-03-27
Crea un nuevo grupo de servidores que contendrán los equipos que alojan las aplicaciones de confianza.
Sintaxis
New-CsTrustedApplicationPool -Identity <XdsGlobalRelativeIdentity> [-AppSharingPortCount <UInt16>] [-AppSharingPortStart <UInt16>] [-AudioPortCount <UInt16>] [-AudioPortStart <UInt16>] [-ComputerFqdn <Fqdn>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-OutboundOnly <$true | $false>] [-Registrar <String>] [-RequiresReplication <$true | $false>] [-Site <String>] [-ThrottleAsServer <$true | $false>] [-TreatAsAuthenticated <$true | $false>] [-VideoPortCount <UInt16>] [-VideoPortStart <UInt16>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Recomendamos que los equipos que ejecutan las aplicaciones de confianza en una instalación de Microsoft Lync Server 2010 se agreguen a un grupo de servidores independiente utilizado únicamente para aplicaciones de confianza. No obstante, se pueden agregar equipos de aplicaciones de confianza a un grupo de servidores existente que también se utiliza con otros fines. Si el grupo de servidores ya existe como parte de la topología, este cmdlet crea el servicio externo asociado a dicho grupo de servidores (con un rol de servidor de ExternalServer). Si el grupo de servidores no existe, este cmdlet crea el grupo de servidores y el servicio correspondiente. (Puede encontrar una lista de todos los grupos de servidores existentes si llama al cmdlet Get-CsPool.)
Al crear un nuevo grupo de servidores de aplicaciones de confianza (un nuevo servicio externo), también se crea un nuevo equipo de aplicaciones de confianza asignado a dicho grupo de servidores. De manera predeterminada, se asignará el mismo nombre de dominio completo (FQDN) al equipo y al grupo de servidores. No obstante, puede especificar su propio valor para el FQDN utilizando el parámetro ComputerFqdn de este cmdlet. Si planea agregar más equipos al grupo de servidores, deberá especificar un valor ComputerFqdn diferente al FQDN del grupo de servidores. Para agregar más equipos al grupo, llame al cmdlet New-CsTrustedApplicationComputer.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet New-CsTrustedApplicationPool localmente: RTCUniversalServerAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsTrustedApplicationPool"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
XdsGlobalRelativeIdentity |
FQDN del nuevo grupo de servidores. Tenga en cuenta que mientras que el valor Identity para crear un grupo de servidores es el FQDN del grupo de servidores, el valor que se almacenará como Identity con el nuevo grupo de servidores es en realidad un identificador de servicio del grupo de servidores generado automáticamente. La Identidad introducida aquí se guardará como PoolFqdn. |
AppSharingPortCount |
Opcional |
Uint16 |
El número de puertos disponible en el intervalo de puertos para conexiones de uso compartido de aplicaciones. Valor predeterminado: 0 |
AppSharingPortStart |
Opcional |
UInt16 |
El número del primer puerto del intervalo de puertos disponible para conexiones de uso compartido de aplicaciones. |
AudioPortCount |
Opcional |
UInt16 |
El número de puertos disponible en el intervalo de puertos para conexiones de audio. Valor predeterminado: 0 |
AudioPortStart |
Opcional |
UInt16 |
El número del primer puerto del intervalo de puertos disponible para conexiones de audio. |
ComputerFqdn |
Opcional |
FQDN |
La creación de un grupo de servidores de aplicaciones de confianza creará automáticamente un equipo de aplicaciones de confianza que forma parte de dicho grupo de servidores. De manera predeterminada, el equipo recibirá el mismo FQDN que el grupo de servidores. Introduzca un valor en este parámetro para especificar un FQDN para el equipo diferente del FQDN del grupo de servidores. Si planea agregar más equipos al grupo de servidores, deberá especificar un valor para este parámetro diferente del FQDN del grupo de servidores. |
OutboundOnly |
Opcional |
Booleano |
Especifica si una aplicación de confianza puede iniciar una conexión a un servidor del grupo de servidores. Establezca este valor en True si desea que el servidor inicie todas las conexiones en lugar de que lo haga la aplicación. Valor predeterminado: False |
Registrar |
Opcional |
Cadena de caracteres |
El id. de servicio o FQDN del servicio Registrar para el grupo de servidores. Tenga en cuenta que aunque este parámetro es opcional; si intenta crear un nuevo extremo de aplicaciones de confianza (con el cmdlet New-CsTrustedApplicationEndpoint) y asigna el extremo a un grupo de servidores que no son dependientes del registrador, recibirá un mensaje de error y no se creará el extremo. Además, no puede quitar un grupo de servidores de aplicaciones de confianza que no esté asociado a un Registrar. |
RequiresReplication |
Opcional |
Booleano |
Determina si se requiere replicación para este grupo de servidores. Establezca este valor en False si no se requiere replicación. Este parámetro se suele establece en False para Microsoft Outlook Web Access y las aplicaciones aprovisionadas manualmente. Valor predeterminado: True |
Site |
Opcional |
Cadena de caracteres |
Id. del sitio en el que se ubica este grupo de servidores. Llame al cmdlet Get-CsSite para obtener la propiedad SiteId de un sitio. No olvide que debe usar esta propiedad en lugar de la propiedad Identity del sitio. Asimismo, tenga en cuenta que SiteId no debe ir precedido de la cadena “site:”, sino que solo deberá especificar SiteId. Además, aunque especifique la propiedad SiteId obtenida de Get-CsSite, la propiedad SiteId del nuevo grupo de aplicaciones de confianza contendrá el parámetro Identity del sitio. Por ejemplo, si la propiedad SiteId del sitio es Main y la propiedad Identity es site:Redmond1, deberá especificar -Site Main cuando llame a New-CsTrustedApplicationPool, pero una siguiente llamada a Get-CsTrustedApplicationPool reflejará SiteId como site:Redmond1. Si el grupo de servidores especificado en Identity ya existe, no será necesario especificar un Sitio. Si el grupo de servidores no existe, este parámetro es obligatorio. |
ThrottleAsServer |
Opcional |
Booleano |
Establezca este parámetro en False para acelerar las conexiones entre los servidores del grupo de servidores y las aplicaciones de confianza como clientes. Esto coloca limitaciones mayores en las conexiones que el valor predeterminado True, que acelera las conexiones como servidores. La aceleración de una conexión establece limitaciones sobre el número de transacciones que pueden producirse a la vez. Valor predeterminado: True |
TreatAsAuthenticated |
Opcional |
Booleano |
Determina si se requiere autenticación para las aplicaciones de confianza que se conectan a los servidores del grupo de servidores. Establezca este parámetro en False si desea exigir que se autentiquen las aplicaciones de confianza. El valor predeterminado de True permite que las aplicaciones de confianza se conecten ya que se asume que ya se han autenticado. Valor predeterminado: True |
VideoPortCount |
Opcional |
UInt16 |
El número de puertos disponible en el intervalo de puertos para conexiones de vídeo. Valor predeterminado: 0 |
VideoPortStart |
Opcional |
Uint16 |
El número del primer puerto del intervalo de puertos disponible para conexiones de vídeo. |
Force |
Opcional |
Parámetro modificador |
Suprime las preguntas de confirmación que aparecerí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
Ninguno.
Tipos de valores devueltos
Crea un objeto de tipo Microsoft.Rtc.Management.Xds.DisplayExternalServer.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
New-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com -Registrar pool0.litwareinc.com -Site Redmond
En este ejemplo se crea un nuevo grupo de servidores con el FQDN TrustPool.litwareinc.com. Utilizamos el parámetro Identity para especificar el nuevo FQDN. Utilizamos el parámetro Registrar con un valor de pool0.litwareinc.com para asociar el nuevo grupo de servidores al servicio de Registrar de ese FQDN. Por último, utilizamos el parámetro Site con un valor de Redmond para especificar que este grupo de servidores formará parte del sitio Redmond.
Tenga en cuenta que el valor de Site es SiteId (que se puede obtener si llama a Get-CsSite). Sin embargo, la propiedad Identity del sitio se almacenará con el nuevo grupo de aplicaciones de confianza. Por ejemplo, si un sitio tiene una propiedad Identity de site:Redmond1 y una propiedad SiteId de NA, deberá usar NA como valor del parámetro Site cuando llame a New-CsTrustedApplicationPool. Sin embargo, si desea encontrar más adelante todos los grupos de aplicaciones de confianza relativos al sitio NA, debería usar el valor de Identity en la cláusula where, como se indica aquí:
Get-CsTrustedApplicationPool | Where-Object {$_.SiteId –eq "site:Redmond1"}
-------------------------- Ejemplo 2 ------------------------
New-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com -Registrar Registrar:redmond.litwareinc.com -Site Redmond -ComputerFqdn AppServer.litwareinc.com
El ejemplo 2 es idéntico al ejemplo 1, salvo que en lugar de especificar un FQDN para el servicio del registrador, hemos utilizado el identificador del servicio, Registrar:redmond.litwareinc.com. Además, hemos especificado un valor para el parámetro ComputerFqdn. Cuando se crea un grupo de servidores, se crea también un equipo en ese grupo de servidores. De manera predeterminada, el equipo tendrá el mismo FQDN que el grupo de servidores. Hemos especificado un FQDN diferente, AppServer.litwareinc.com, para el equipo que está en este grupo de servidores.