Get-CsSite
Tópico modificado em: 2012-03-23
Retorna informações sobre os sites criados como parte da sua infraestrutura do Microsoft Lync Server 2010. Os sites representam uma coleção de pools do Lync Server 2010 e normalmente são projetados tendo em vista as regiões geográficas. O Lync Server inclui dois tipos de sites: sites de data center e sites remotos (filiais).
Sintaxe
Get-CsSite [-Identity <XdsGlobalRelativeIdentity>]
Get-CsSite [-Filter <String>]
Descrição Detalhada
O Lync Server 2010 apresenta um novo conceito à topologia do Lync Server: sites. Sites (que não devem ser confundidos com sites do Active Directory ou sites do Microsoft Exchange Server) formam uma coleção de pools do Lync Server e servidores normalmente organizados de acordo com a geografia e a largura de banda da rede. Por exemplo, se todos os computadores em Redmond estiverem na mesma rede local com conexões de alta velocidade e baixa latência, você poderá designar um site de Redmond que inclua esses computadores. Se os computadores em Dublin estiverem na rede local própria e compartilharem conexões de alta velocidade e baixa latência, você também poderá criar um site de Dublin à parte. Os sites têm um papel importante no gerenciamento do Lync Server: a maioria das diretivas e das configurações pode ser definida no escopo do site, o que facilita a realização de tarefas como a aplicação de um conjunto de planos de discagem para usuários em Redmond e de um conjunto totalmente diferente de planos de discagem para usuários em Dublin.
O cmdlet Get-CsSite permite retornar informações sobre todos os sites na organização, inclusive informações sobre os pools que constituem cada um desses sites.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsSite localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsSite"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
SiteId |
Nome do site a ser retornado. Observe que você deve especificar apenas o nome do site; por exemplo: -Identity "Redmond". Não use o formato "site:Redmond" ao especificar a Identidade. |
Filter |
Opcional |
Cadeia de caracteres |
Permite usar curingas durante a especificação da Identity do site (ou sites) a ser retornado. Por exemplo, essa sintaxe retorna todos os pools que tenham uma Identity incluindo o valor da cadeia de caracteres "Dublin": -Filter "*Dublin*". Observe que não é possível usar Filter e Identity no mesmo comando. |
Tipos de Entrada
Nenhuma. Get-CsSite não aceita entrada em pipeline.
Tipos de Retorno
Get-CsSite retorna instâncias do objeto Microsoft.Rtc.Management.Deploy.Internal.Site+CentralSite.
Exemplo
-------------------------- Exemplo 1 --------------------------
Get-CsSite
O Exemplo 1 recupera informações de todos os sites do Lync Server.
-------------------------- Exemplo 2 --------------------------
Get-CsSite -Identity "Redmond"
No Exemplo 2, as informações retornam de um único site: o site com a Identity Redmond.
-------------------------- Exemplo 3 --------------------------
Get-CsSite | Where-Object {$_.SiteType -eq "CentralSite"}
O comando mostrado no Exemplo 3 retorna informações para o site central. Para realizar essa tarefa, o comando chama inicialmente Get-CsSite para retornar uma coleção de todos os sites configurados para uso na organização. Em seguida, essa coleção é redirecionada para o Where-Object, que separa o site no qual a propriedade SiteType é igual a "CentralSite".
-------------------------- Exemplo 4 --------------------------
Get-CsSite -Identity "Redmond" | Select-Object -ExpandProperty Pools
O comando anterior exibe a lista de pools encontrados no site de Redmond. Para isso, o comando recupera inicialmente as informações completas do site de Redmond e, em seguida, redireciona esses dados para o cmdlet Select-Object. Por sua vez, Select-Object usa o parâmetro ExpandProperty para "expandir" o valor da propriedade Pools. A expansão de um valor de propriedade significa que todos os valores armazenados nessa propriedade serão exibidos na tela em um formato que facilita a leitura.