Get-CsComputer
Tópico modificado em: 2012-03-23
Retorna informações sobre os computadores que executam funções de serviço na infraestrutura do Microsoft Lync Server 2010.
Sintaxe
Get-CsComputer [-Identity <XdsGlobalRelativeIdentity>] [-Pool <String>]
Get-CsComputer [-Filter <String>] [-Pool <String>]
Descrição Detalhada
Get-CsComputer possibilita identificar rapidamente os computadores que estiverem executando funções de serviços ou de servidor do Lync Server 2010. Chamado sem nenhum parâmetro, Get-CsComputer retorna uma coleção de todos os computadores que estiverem executando funções de serviço ou de servidor do Lync Server 2010. Essa coleção inclui a Identidade, o nome do pool e o nome de domínio totalmente qualificado (FQDN) de cada computador. É possível utilizar parâmetros opcionais como Identity, Filter ou Pool para limitar os dados retornados a um único computador ou a um grupo de computadores.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsComputer localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins e RTCUniversalReadOnlyAdmins.
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
Cadeia de caracteres |
FQDN do computador a ser retornado. Por exemplo: -Identity "atl-cs-001.litwareinc.com". Se esse parâmetro não for especificado, serão retornados todos os computadores que estiverem executando o Lync Server 2010. |
Filter |
Opcional |
Cadeia de caracteres |
Permite utilizar caracteres curinga ao se especificar a identidade do computador (ou computadores) a ser retornada. Por exemplo, este comando retorna informações sobre todos os computadores cuja identidade começar com o valor da cadeia de caracteres "atl-": -Filter "atl-*". |
Pool |
Opcional |
Cadeia de caracteres |
FQDN de um pool do Lync Server 2010. Ao se utilizar esse parâmetro, serão retornadas informações sobre todos os computadores no pool especificado. |
Tipos de Entrada
Nenhuma. Get-CsComputer não aceita a entrada canalizada.
Tipos de Retorno
Get-CsComputer retorna instâncias do objeto Microsoft.Rtc.Management.Deploy.Internal.Machine.
Exemplo
-------------------------- Exemplo 1 --------------------------
Get-CsComputer
No Exemplo 1, o cmdlet Get-CsComputer é utilizado para retornar informações sobre todos os computadores que executarem funções de serviço na infraestrutura do Lync Server 2010.
-------------------------- Exemplo 2 --------------------------
Get-CsComputer -Filter "*.litwareinc.com"
O comando apresentado no Exemplo 2 utiliza o parâmetro Filter, para retornar apenas os computadores de funções de serviço que fizerem parte do domínio litwareinc.com. A cadeia de caracteres curinga *.litwareinc.com restringe as informações retornadas a computadores cujo FQDN termine com o valor de cadeia de caracteres ".litwareinc.com".
-------------------------- Exemplo 3 --------------------------
Get-CsComputer -Identity "atl-cs-001.litwareinc.com"
No exemplo anterior, o parâmetro Identity é utilizado para limitar os dados retornados a um computador cujo nome de domínio totalmente qualificado for atl-cs-001.litwareinc.com.
-------------------------- Exemplo 4 --------------------------
Get-CsComputer -Pool "atl-cs-001.litwareinc.com"
No Exemplo 4, o parâmetro Pool é usado para retornar informações sobre todos os computadores encontrados no pool atl-cs-001.litwareinc.com.