Set-CsSite
Tópico modificado em: 2012-03-26
Modifica as propriedades de qualquer um dos sites do Microsoft Lync Server 2010. Os sites representam uma coleção de pools do Lync Server 2010 e são normalmente projetados levando em conta regiões geográficas. O Lync Server inclui dois tipos de sites: sites de data center e sites remotos (filiais).
Sintaxe
Set-CsSite [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayName <String>] [-FederationRoute <String>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
O Lync Server 2010 introduz um novo conceito na topologia do Lync Server: sites. Os sites (que não devem ser confundidos com os sites do Active Directory ou os sites do Microsoft Exchange Server) são uma coleção de pools e servidores do Lync Server que são normalmente organizados de acordo com a geografia e a largura de banda de rede. Por exemplo: se todos os seus computadores de Redmond estiverem localizados na mesma rede de área local com conexões de alta velocidade e baixa latência, será possível designar um site de Redmond que abranja esses computadores. Se os seus computadores em Dublin estiverem localizados em sua própria rede de área local e compartilharem conexões de alta velocidade e baixa latência, também será possível criar um site de Dublin separado. Os sites também desempenham uma função vital no gerenciamento do Lync Server: muitas políticas e definições podem ser configuradas no escopo de site, facilitando a aplicação de um conjunto de planos de discagem a usuários em Redmond e um conjunto de planos de discagem diferente em Dublin.
Os sites são criados utilizando-se o Construtor de Topologias. Qualquer alteração à infraestrutura do site (a adição de novos pools, por exemplo) também deverá ser feita mediante o uso do Construtor de topologia. No entanto, é possível usar o cmdlet Set-CsSite para alterar o nome de exibição, a descrição e a rota de federação de qualquer site na organização.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsSite localmente: 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 "Set-CsSite"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
Identidade de Xds |
Nome do site a ser modificado; por exemplo: -Identity "Redmond". Não utilize o formato "site:Redmond" ao especificar a identidade. |
Description |
Opcional |
Cadeia de caracteres |
Permite aos administradores adicionar mais informações a um objeto de site. Por exemplo, Descrição deve incluir as informações de contato do site. |
DisplayName |
Opcional |
Cadeia de caracteres |
Nome intutivo do site. Por exemplo: -DisplayName "América do Norte e América do Sul". |
FederationRoute |
Opcional |
Cadeia de caracteres |
Local de serviço do Servidor de Borda utilizado para fornecer uma ponte entre a rede interna e a Internet. Por exemplo: -FederationRoute "EdgeServer:atl-edge-001.litwareinc.com". |
Force |
Opcional |
Parâmetro de opção |
Suprime os prompts de confirmação ou mensagens de erro não fatal que podem ocorrer quando você executa o cmdlet. |
WhatIf |
Opcional |
Parâmetro de opção |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
Parâmetro de opção |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Nenhuma. Set-CsSite não aceita a entrada canalizada.
Tipos de Retorno
Set-CsSite não retorna qualquer objeto ou valor. Em vez disso, o cmdlet modifica instâncias do objeto Microsoft.Rtc.Management.Deploy.Internal.Site+CentralSite.
Exemplo
-------------------------- Exemplo 1 ------------------------
Set-CsSite -Identity Redmond -Description "Full-time employees in Redmond, WA."
O comando exibido no Exemplo 1 modifica a propriedade Description do site Redmond (-Identity Redmond).
-------------------------- Exemplo 2 ------------------------
Set-CsSite -Identity Redmond -DisplayName "US Headquarters"
O comando anterior altera o nome de exibição do site de Redmond para "Sede nos EUA".
-------------------------- Exemplo 3 ------------------------
Get-CsSite | Where-Object {$_.Description -eq $Null} | ForEach-Object {Set-CsSite $_.Identity -Description "Litwareinc.com"}
O comando exibido no Exemplo 3 localiza todos os sites que não possuírem uma Descrição e, em seguida, atribui a cada um desses sites a descrição genérica "Litwareinc.com." Para isso, o comando primeiramente chama Get-CsSite, sem qualquer parâmetro, para retornar uma coleção de todos os sites do Lync Server. Essa coleção retornada será então canalizada para o cmdlet Where-Object, que selecionará apenas os sites cuja propriedade Description for igual a (-eq) um valor nulo ($Null). Esses sites serão então canalizados para o cmdlet ForEach-Object. Esse cmdlet selecionará um item da coleção por vez e utilizará Set-CsSite para modificar o valor da propriedade Description.