Get-CsService
Tópico modificado em: 2012-03-23
Retorna informações sobre os serviços e as funções de servidor que estiverem sendo usados na infraestrutura do Microsoft Lync Server 2010. Um serviço é uma instância de uma função que foi implantada em um pool do Lync Server 2010. Por exemplo: é possível que, em um pool, todos os computadores esteja executando o serviço Servidor de monitoramento.
Sintaxe
Get-CsService [-Identity <XdsGlobalRelativeIdentity>] [-PoolFqdn <String>]
Get-CsService [-ApplicationServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ApplicationDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ArchivingServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ArchivingDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-CentralManagement <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-CentralManagementDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ConferencingServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-Director <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-EdgeServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-PoolFqdn <String>] [-TrustedApplicationPool <SwitchParameter>]
Get-CsService [-FileStore <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-ManagementServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-MediationServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-MonitoringServer <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-MonitoringDatabase <SwitchParameter>] [-PoolFqdn <String>]
Get-CsService [-PoolFqdn <String>] [-PstnGateway <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-ProvisionServer <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-ProvisionDatabase <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-Registrar <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-UserServer <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-UserDatabase <SwitchParameter>]
Get-CsService [-PoolFqdn <String>] [-WebServer <SwitchParameter>]
Get-CsService [-Filter <String>] [-PoolFqdn <String>]
Descrição Detalhada
Normalmente, as capacidades encontradas no Lync Server 2010 são expressas como serviços ou funções de servidor. Por exemplo: é possível configurar o Lync Server de modo que ele salve automaticamente uma transcrição de cada sessão de mensagens instantâneas que ocorrer na organização. Para isso, é necessário instalar a função de servidor Servidor de Arquivamento. É possível configurar os serviços e as funções de servidor simultaneamente à instalação do Lync Server ou quando o software já estiver em execução.
O cmdlet Get-CsService permite retornar informações sobre as funções de servidor e os serviços em execução na organização. Chamado sem qualquer parâmetro adicional, Get-CsService retornará informações detalhadas sobre todos os serviços e funções de servidor. Como alternativa, é possível limitar os dados retornados a um pool especificado, utilizando-se o parâmetro PoolFqdn. Além disso, é possível utilizar qualquer número de parâmetros de opção para limitar os dados retornados a um tipo específico de serviço. Um parâmetro de opção é um parâmetro que não exige um valor. Por exemplo, esse comando retorna informações sobre todos os Servidores de Arquivamento:
Get-CsService –ArchivingServer
Observe que é possível utilizar apenas um desses parâmetros de opção por comando. O comando a seguir, que tenta retornar informações sobre os Servidores de arquivamento e os Servidores de monitoramento, falhará:
Get-CsService –ArchivingServer –MonitoringServer
Para retornar informações sobre diversas funções de servidor, utilize Get-CsService para retornar uma coleção completa dos dados de serviço e, em seguida, canalize esses dados para o cmdlet Where-Object:
Get-CsService | Where-Object {$_.Role –eq "ArchivingServer" –or $_.Role –eq "MonitoringServer"}
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsService localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. 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-CsService"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Opcional |
Identidade de Xds |
Identificador exclusivo do serviço ou função específica de servidor a ser retornada. Por exemplo: -Identity "Registrar:atl-cs-001.litwareinc.com". |
Filter |
Opcional |
Cadeia de caracteres |
Permite utilizar caracteres curinga para especificar o serviço (ou serviços) a serem retornados. Não é possível utilizar os parâmetros Identity e Filter no mesmo comando. |
ApplicationDatabase |
Opcional |
Parâmetro de opção |
Retorna informações sobre os bancos de dados de aplicativos utilizados na organização. Os bancos de dados de aplicativos são utilizados pelo Serviço de aplicativos. |
ApplicationServer |
Opcional |
Parâmetro de opção |
Retorna as informações sobre o Serviço de aplicativos. O Serviço de aplicativos fornece uma maneira de executar aplicativos criados usando o Microsoft Unified Communications Managed API (UCMA). |
ArchivingDatabase |
Opcional |
Parâmetro de opção |
Retorna informações sobre os bancos de dados de arquivamento utilizados na organização. Os bancos de dados de arquivamento armazenam transcrições de sessões de mensagens instantâneas. |
ArchivingServer |
Opcional |
Parâmetro de opção |
Retorna informações sobre os Servidores de Arquivamento utilizados na organização. Os Servidores de arquivamento permitem salvar as transcrições de sessões de mensagens instantâneas. |
CentralManagement |
Opcional |
Parâmetro de opção |
Retorna informações sobre o Serviço de Gerenciamento Central utilizado na organização. O Serviço de Gerenciamento Central é usado para enviar dados de configuração a computadores que estiverem executando os serviços do Lync Server 2010. |
CentralManagementDatabase |
Opcional |
Parâmetro de opção |
Retorna informações sobre o Repositório de Gerenciamento Central utilizado na organização. O Repositório de Gerenciamento Central mantém as informações de configuração de Lync Server. |
ConferencingServer |
Opcional |
Parâmetro de opção |
Retorna informações sobre o Serviço de Conferência A/V utilizado na organização. O Serviço de Conferência A/V é usado para conduzir reuniões e conferências. |
Director |
Opcional |
Parâmetro de opção |
Retorna informações sobre os Diretores utilizados na organização. Os Diretores podem gerenciar solicitações e autenticações de usuários, mas não hospedam contas de usuários. Os Diretores normalmente são utilizados para gerenciar as solicitações de usuários externos. |
EdgeServer |
Opcional |
Parâmetro de opção |
Retorna informações sobre os Servidores de Borda utilizados na organização. Os Servidores de Borda fornecem conectividade entre a rede interna e a Internet. |
FileStore |
Opcional |
Parâmetro de opção |
Retorna informações sobre os Repositórios de Arquivos utilizados na organização. O Repositório de arquivos é utilizado para manter arquivos do Lync Server, como arquivos de áudio utilizados pelo serviço de comunicados. |
ManagementServer |
Opcional |
Parâmetro de opção |
Retorna informações sobre o Servidor de Gerenciamento Central utilizado na organização. O Servidor de Gerenciamento Central é normalmente posicionado com os Servidores de front end e é resonsável por acessar informações no Repositório de Gerenciamento Central. |
MediationServer |
Opcional |
Parâmetro de opção |
Retorna informações sobre os Servidores de Mediação utilizados na organização. Os Servidores de mediação ajudam a estabelecer uma ligação entre a rede do Enterprise Voice e a rede telefônica pública comutada (PSTN). |
MonitoringServer |
Opcional |
Parâmetro de opção |
Retorna informações sobre os Servidores de Monitoramento utilizados na organização. Os Servidores de Armazenamento são utilizados para rastrear o uso do telefone no Enterprise Voice e a qualidade das chamadas. |
MonitoringDatabase |
Opcional |
Parâmetro de opção |
Retorna informações sobre os bancos de dados de monitoramento utilizados na organização. Os bancos de dados de monitoramento armazenam informações de uso do telefone no Enterprise Voice e da qualidade das chamadas. |
PoolFqdn |
Opcional |
Cadeia de caracteres |
Nome de domínio totalmente qualificado (FQDN) do pool que hospeda o serviço ou a função de servidor. Se o parâmetro PoolFqdn for usado, sem se especificar um parâmetro específico ao serviço, serão retornados todos os serviços e as funções de servidor encontrados nesse pool. |
ProvisionServer |
Opcional |
Parâmetro de opção |
Retorna informações sobre o serviço Servidor de provisionamento utilizado na organização. O serviço Servidor de provisionamento é usado para gerenciar certificados do Lync Server. |
ProvisionDatabase |
Opcional |
Parâmetro de opção |
Retorna informações sobre os bancos de dados de provisionamento utilizados na organização. Os bancos de dados de provisionamento mantêm informações sobre os certificados do Lync Server. |
PstnGateway |
Opcional |
Parâmetro de opção |
Retorna informações sobre os gateways da rede telefônica pública comutada (PSTN) utilizados na organização. Os gateways da PSTN convertem sinais de dispositivos do Enterprise Voice em sinais que podem ser compreendidos por dispositivos da PSTN e vice-versa. |
Registrar |
Opcional |
Parâmetro de opção |
Retorna informações sobre os Registradores utilizados na organização. Os Registradores são usados para autenticar os usuários e acompanhar o status de um usuário. |
TrustedApplicationPool |
Opcional |
Parâmetro de opção |
Retorna informações sobre os pool de aplicativos confiáveis utilizados na organização. Os pools de aplicativos confiáveis hospedam computadores que executam aplicativos confiáveis. |
UserDatabase |
Opcional |
Parâmetro de opção |
Retorna informações sobre o Banco de dados de usuários utilizado na organização. Os bancos de dados de usuários armazenam os dados exigidos pelo serviço Servidor de usuários. |
UserServer |
Opcional |
Parâmetro de opção |
Retorna informações sobre o serviço do Serviços de Usuário utilizado na organização. O serviço de Serviços de Usuário disponibiliza serviços como replicação, provisionamento em banda, publicação e notificação de presença e troca de cartões de visita. |
WebServer |
Opcional |
Parâmetro de opção |
Retorna informações sobre o serviço do Serviços Web utilizado na organização. O serviço de Serviços Web hospeda aplicativos com base na Web, como o Serviço Catálogo de endereços. |
Tipos de Entrada
Nenhuma. Get-CsService não aceita a entrada canalizada.
Tipos de Retorno
Get-CsService retorna diferentes objetos, com base nos parâmetros utilizados ao ser chamado. Por exemplo: caso se inclua o parâmetro MonitoringDatabase, Get-CsService retornará instâncias do objeto Microsoft.Rtc.Management.Xds.DisplayMonitoringDatabase. Para determinar os objetos retornados utilizando-se outros parâmetros, chame Get-CsService utilizando um desses parâmetros e, em seguida, canalize o objeto retornado para o cmdlet Get-Member. Por exemplo: Get-CsService -Registrar | Get-Member.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsService
O comando apresentado no Exemplo 1 retorna informações sobre todos os serviços e as funções de servidor do Lync Server 2010 que estiverem em execução na organização.
-------------------------- Exemplo 2 ------------------------
Get-CsService -ApplicationServer
O Exemplo 2 retorna informações apenas sobre o Serviço de aplicativos. É possível retornar informações sobre outros serviços/funções de servidor, utilizando-se o parâmetro relevante. Por exemplo, esse comando retorna informações sobre o armazenamento de arquivos:
Get-CsService -FileStore
-------------------------- Exemplo 3 ------------------------
Get-CsService -PoolFqdn "atl-cs-001.litwareinc.com" | Select-Object Identity
O comando anterior relata a Identidade de cada serviço localizado no pool atl-cs-001.litwareinc.com. Para realizar essa tarefa, o comando primeiramente chama Get-CsService e o parâmetro PoolFqdn, para retornar apenas os serviços e as funções de servidor localizados no pool atl-cs-001.litwareinc.com. Essa coleção será então canalizada para o cmdlet Select-Object, que relatará a Identidade de cada item na coleção.
-------------------------- Exemplo 4 ------------------------
Get-CsService | Where-Object {$_.SiteID -eq "site:Redmond"}
No Exemplo 4, retornam-se informações sobre todos os serviços/funções de servidor localizados no site de Redmond. Isso é feito chamando-se primeiramente Get-CsService, sem qualquer parâmetro, para que retorne uma coleção de todos os serviços e funções de servidor em uso na organização. Esses dados serão então canalizados para o cmdlet Where-Object, que selecionará apenas os itens cuja propriedade SiteID for igual a site:Redmond.
-------------------------- Exemplo 5 ------------------------
Get-CsService | Where-Object {$_.DependentServiceList -like "*Registrar*"}
O comando exibido no Exemplo 5 retorna informações sobre todos os serviços que listarem Registrador como serviço dependente. Para isso, chama-se Get-CsService, para retornar uma coleção de todos os serviços e funções de servidor em uso. Essa coleção será então canalizada para Where-Object, que selecionará cada item cuja propriedade DependentServiceList incluir o valor de cadeia de caracteres "Registrar". O critério Where-Object é especificado utilizando-se o operador -like e o valor de caractere curinga "*Registrar*".