Get-CsPool
Tópico modificado em: 2012-03-23
Retorna informações sobre os pools utilizados na implantação do Microsoft Lync Server 2010. Os pools são coleções de computadores em um local onde todos executam o mesmo conjunto de serviços do Lync Server 2010.
Sintaxe
Get-CsPool [-Identity <XdsGlobalRelativeIdentity>] [-Site <String>]
Get-CsPool [-Filter <String>] [-Site <String>]
Descrição Detalhada
No Lync Server 2010, um pool consiste em um ou mais computadores no mesmo local que estiverem executando o mesmo conjunto de serviços. Por exemplo: se houver um servidor executando o serviço do Servidor de Mediação no site de Redmond, este pool do Servidor de Mediação consistirá em um único computador. Se houver dois computadores executando o Servidor de Mediação no site de Redmond, este pool do Servidor de Mediação consistirá em dois computadores. O número de pools usados na organização depende do número de servidores e dos diferentes serviços executados por esses servidores.
O cmdlet Get-CsPool permite recuperar informações sobre cada pool em uso na organização, inclusive informações sobre os serviços em execução em cada pool.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsPool localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins e RTCUniversalReadOnlyAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsPool"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Opcional |
Cadeia de caracteres |
Nome do domínio totalmente qualificado (FQDN) do pool a ser retornado. Por exemplo: -Identity atl-cs-001.litwareinc.com. Se esse parâmetro não estiver presente, serão retornados todos os pools da organização. |
Filter |
Opcional |
Cadeia de caracteres |
Permite utilizar caracteres curingas ao especificar a Identidade do pool (ou pools) a ser retornada. Por exemplo, essa sintaxe retorna todos os pools que possuírem uma Identidade que termine com o valor de cadeia de caracteres ".fabrikam.com": -Filter "*.fabrikam.com". Observe que não é possível utilizar os parâmetros Filter e Identity no mesmo comando. |
Site |
Opcional |
Cadeia de caracteres |
Retorna todos os pool localizados no site especificado. Observe que a referência ao site em questão deve utilizar o DisplayName do site (Redmond, por exemplo) em vez da Identidade do site (site:Redmond, por exemplo). Por exemplo: -Site "Redmond". É possível recuperar os nomes de exibição dos sites executando-se esse comando: Get-CsSite | Select-Object Identity, DisplayName |
Tipos de Entrada
Nenhuma. Get-CsPool não aceita a entrada canalizada.
Tipos de Retorno
Get-CsPool retorna instâncias do objeto Microsoft.Rtc.Management.Deploy.Internal.Cluster.
Exemplo
-------------------------- Exemplo 1 --------------------------
Get-CsPool
O comando anterior retorna todos os pools encontrados na implantação do Lync Server.
-------------------------- Exemplo 2 --------------------------
Get-CsPool | Select-Object -ExpandProperty Computers
O Exemplo 2 exibe informações detalhadas sobre os computadores encontrados em cada pool. Isso é feito chamando-se Get-CsPool e canalizando-se os dados retornados para o cmdlet Select-Object. Utiliza-se o parâmetro ExpandProperty de Select-Object para "expandir" o valor da propriedade Computers. A propriedade Computers é uma matriz de objetos que representam cada computador no pool. Ao expandir a propriedade Computers, você receberá informações detalhadas sobre cada um desses computadores.
-------------------------- Exemplo 3 --------------------------
Get-CsPool -Identity atl-cs-001.litwareinc.com
No exemplo anterior, utiliza-se o parâmetro Identity para restringir os dados retornados ao pool cuja Identidade for atl-cs-001.litwareinc.com.
-------------------------- Exemplo 4 --------------------------
Get-CsPool -Site "Redmond"
O Exemplo 4 retorna todos os pools encontrados no site de Redmond. Para fazer isso, o comando usa o parâmetro Site. O valor de parâmetro "Redmond" limita os dados retornados aos pools cuja propriedade Site for igual a Redmond.
-------------------------- Exemplo 5 --------------------------
Get-CsPool | Where-Object {$_.Services.Count -eq 0}
O comando exibido no Exemplo 5 retorna uma coleção de todos os pools que não possuírem nenhum serviço do Lync Server instalado. Para realizar essa tarefa, o comando chama primeiramente Get-CsPool, sem quaisquer parâmetros. Isto retorna uma coleção de todos os pools em uso na organização. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará todos os pools cuja propriedade Services.Count for igual a 0. Se Count for igual 0, não haverá serviços do Lync Server configurados nesse pool.