New-CsTrustedApplicationPool
Tópico modificado em: 2012-03-27
Cria um novo pool que conterá os computadores que hospedam aplicativos confiáveis.
Sintaxe
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>]]
Descrição Detalhada
Recomendamos que os computadores que estiverem executando aplicativos em uma implantação do Microsoft Lync Server 2010 sejam adicionados a um pool separado, destinado apenas a aplicativos confiáveis. No entanto, é possível adicionar computadores de aplicativos confiáveis a um pool existente que também é usado para outros fins. Se o pool já existir como parte da topologia, esse cmdlet criará o serviço externo associado a esse pool (com uma função de serviço do ExternalServer). Se o pool não existir, esse cmdlet criará o pool e o serviço correspondente. É possível localizar uma lista de todos os pools existentes chamando o cmdlet Get-CsPool).
A criação de um novo pool de aplicativos confiáveis (um novo serviço externo) também cria um novo computador de aplicativos confiáveis atribuído a esse pool. Por padrão, o mesmo nome de domínio totalmente qualificado (FQDN) do pool será atribuído ao computador. No entanto, é possível especificar um valor de sua escolha para o FQDN, usando o parâmetro ComputerFqdn para esse cmdlet. Se você planeja adicionar mais computadores ao pool, é necessário especificar um valor ComputerFqdn diferente do FQDN do pool. Para adicionar mais computadores ao pool, chame o cmdlet New-CsTrustedApplicationComputer.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-CsTrustedApplicationPool localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsTrustedApplicationPool"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
XdsGlobalRelativeIdentity |
O FQDN do novo pool. Observe que enquanto o valor da Identidade para criar um pool é o FQDN do pool, o valor que será armazenado como a Identidade com o novo pool é, na verdade, um ID de serviço do pool gerado automaticamente. A Identidade inserida aqui será salva como o PoolFqdn. |
AppSharingPortCount |
Opcional |
Uint16 |
O número de portas disponíveis no intervalo de portas para conexões de compartilhamento de aplicativos. Padrão: 0 |
AppSharingPortStart |
Opcional |
UInt16 |
O número da primeira porta, no intervalo de portas disponível para conexões de compartilhamento de aplicativos. |
AudioPortCount |
Opcional |
UInt16 |
O número de portas disponíveis, no intervalo de portas para conexões de áudio. Padrão: 0 |
AudioPortStart |
Opcional |
UInt16 |
O número da primeira porta, no intervalo de portas disponível para conexões de áudio. |
ComputerFqdn |
Opcional |
FQDN |
A criação de um pool de aplicativos confiáveis criará automaticamente um computador de aplicativos confiáveis integrante desse pool. Por padrão, o computador receberá o mesmo FQDN que o pool. Insira um valor nesse parâmetro, para especificar um FQDN para o computador que seja diferente do FQDN do pool. Se você planeja adicionar mais computadores ao pool, é necessário inserir um valor para esse parâmetro que seja diferente do FQDN do pool. |
OutboundOnly |
Opcional |
Booleano |
Especifica se um aplicativo confiável pode iniciar uma conexão com um servidor dentro do pool. Defina esse valor como Verdadeiro, se desejar que todas as conexões sejam iniciadas pelo servidor, e não pelo aplicativo. Padrão: Falso |
Registrar |
Opcional |
Cadeia de caracteres |
O ID de serviço ou FQDN do serviço de Registrador para o pool. Observe que, embora esse parâmetro seja opcional, se você tentar criar um novo ponto de extremidade do aplicativo confiável (usando o cmdlet New-CsTrustedApplicationEndpoint) e atribuir o ponto de extremidade a um pool que não possua uma dependência do Registrador, você receberá um erro e o ponto de extremidade não será criado. Além disso, não é possível remover um pool do aplicativo confiável que não esteja associado a um Registrador. |
RequiresReplication |
Opcional |
Booleano |
Determina se a replicação é necessária para esse pool. Defina esse valor como Falso, se a replicação não for necessária. Geralmente, esse parâmetro é definido como False no Microsoft Outlook Web Access e em aplicativos manualmente provisionados. Padrão: Verdadeiro |
Site |
Opcional |
Cadeia de caracteres |
O ID do site no qual o pool está hospedado. Chame o cmdlet Get-CsSite para recuperar a propriedade SiteId de um site. Lembre-se de usar a propriedade SiteId, em vez da Identidade do site. Observe também que não se deve preceder SiteId com a cadeia de caracteres “site:”. É necessário inserir apenas o SiteId. Além disso, mesmo que você insira o SiteId recuperado com Get-CsSite, a propriedade SiteId do novo pool de aplicativos confiáveis conterá a Identidade do site. Por exemplo, se SiteId do site for Main e o site Identity for site:Redmond1, será necessário inserir -Site Main em sua chamada para New-CsTrustedApplicationPool, mas uma chamada subsequente a Get-CsTrustedApplicationPool exibirá o SiteId como site:Redmond1. Se o pool especificado na Identidade já existir, não será necessário especificar um Site. Se o pool não existir, esse parâmetro será necessário. |
ThrottleAsServer |
Opcional |
Booleano |
Defina esse parâmetro como falso, para restringir conexões entre os servidores no pool e aplicativos confiáveis como clientes. Isso coloca restrições maiores nas conexões do que o padrão True, que restringe conexões como servidores. A restrição de uma conexão restringe o número de transações que podem ocorrer simultaneamente. Padrão: Verdadeiro |
TreatAsAuthenticated |
Opcional |
Booleano |
Determina se a autenticação é necessária para aplicativos confiáveis que se conectam a servidores dentro do pool. Defina esse parâmetro como Falso, se desejar que aplicativos confiáveis sejam obrigatoriamente autenticados. O valor padrão Verdadeiro permite que os aplicativos confiáveis se conectem, presumindo que eles já tenham sido autenticados. Padrão: Verdadeiro |
VideoPortCount |
Opcional |
UInt16 |
O número de portas disponíveis no intervalo de portas para conexões de vídeo. Padrão: 0 |
VideoPortStart |
Opcional |
Uint16 |
O número da primeira porta, no intervalo de portas disponível para conexões de vídeo. |
Force |
Opcional |
SwitchParameter |
Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de realizar alterações. |
WhatIf |
Opcional |
SwitchParameter |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
SwitchParameter |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Nenhuma.
Tipos de Retorno
Cria um objeto do tipo Microsoft.Rtc.Management.Xds.DisplayExternalServer.
Exemplo
-------------------------- Exemplo 1 ------------------------
New-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com -Registrar pool0.litwareinc.com -Site Redmond
Esse exemplo cria um novo pool com o FQDN TrustPool.litwareinc.com. Usamos o parâmetro Identidade para especificar o novo FQDN. Usamos o parâmetro Registrador com um valor pool0.litwareinc.com para associar o novo pool ao serviço Registrador nesse FQDN. Finalmente, usamos o parâmetro Site com um valor Redmond para especificar se esse pool será parte do site Redmond.
Observe que o valor de Site é SiteId (que pode ser recuperado chamando-se Get-CsSite). No entanto, a Identidade do site será armazenada com o novo pool de aplicativos confiáveis. Por exemplo, se um site possuir uma Identidade igual asite:Redmond1 e um SiteId igual a NA, será necessário usar NA como o valor do parâmetro Site na chamada a New-CsTrustedApplicationPool. No entanto, se quiser localizar posteriormente todos os pools de aplicativos confiváveis correspondentes ao site NA, o valor Identity poderá ser usado em sua cláusula where, como a seguir:
Get-CsTrustedApplicationPool | Where-Object {$_.SiteId –eq "site:Redmond1"}
-------------------------- Exemplo 2 ------------------------
New-CsTrustedApplicationPool -Identity TrustPool.litwareinc.com -Registrar Registrar:redmond.litwareinc.com -Site Redmond -ComputerFqdn AppServer.litwareinc.com
O Exemplo 2 é idêntico ao Exemplo 1, exceto que, em vez de especificar um FQDN para o serviço Registrador, usamos o ID do serviço (Registrar:redmond.litwareinc.com). Além disso, especificamos um valor para o parâmetro ComputerFqdn. Quando se cria um pool, também é criado um computador dentro desse pool. Por padrão, o computador terá o mesmo FQDN que o pool. Especificamos um FQDN diferente (AppServer.litwareinc.com) para o computador que está nesse pool.
Consulte Também
Outros Recursos
Remove-CsTrustedApplicationPool
Set-CsTrustedApplicationPool
Get-CsTrustedApplicationPool
New-CsTrustedApplicationComputer
Get-CsSite