Set-CsUserServer
Tópico modificado em: 2012-04-23
Permite modificar um pool de Serviços do Usuário existente. Entre muitas outras coisas, o pool de Serviços do usuário fornece informações de presença e ajuda a gerenciar as conferências.
Sintaxe
Set-CsUserServer [-Identity <XdsGlobalRelativeIdentity>] [-ConferenceServer <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-McuFactorySipPort <UInt16>] [-UserDatabase <String>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Os Serviços do usuário é um componente abrangente que realiza diversas funções-chave do Microsoft Lync Server 2010. Por exemplo: os Serviços do usuário fornecem informações de presença, ajudam a gerenciar as conferências (no Foco e no Alocador de Foco), gerenciam as autorizações de usuários e o roteamento no nível do usuário e atua como interface principal para o banco de dados de back-end. Os Serviços de Usuário também contribuem para o provisionamento de contas de usuários.
Por isso, é importante para os administradores saber exatamente como foram configurados os pools de Serviços do Usuário e, se necessário, modificar essas configurações. É possível recuperar informações sobre os pools dos Serviços do Usuário utilizando o seguinte comando:
Get-CsService -UserServer
Da mesma maneira, é possível utilizar o cmdlet Set-CsUserServer para fazer alterações a qualquer um desses pools. Set-CsUserServer permite que os administradores alterem o banco de dados do usuário e/ou o servidor de conferências associado a um pool. O cmdlet também permite modificar a porta usada para conexões com o Alocador de foco.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsUserServer localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (inclusive qualquer função RBAC personalizada criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsUserServer"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Opcional |
Identidade de Xds |
Identificador exclusivo do pool de Serviços do Usuário a ser modificado. Por exemplo: -Identity "UserServer:atl-cs-001.litwareinc.com". Observe que você pode omitir o prefixo "UserServer:" ao especificar um servidor de usuários. Por exemplo: -Identity "atl-cs-001.litwareinc.com". |
ConferenceServer |
Opcional |
Cadeia de caracteres |
ID do serviço do servidor de conferências associado ao pool de Serviços do usuário. Por exemplo: -ConferenceServer "ConferenceServer:atl-cs-001.litwareinc.com". |
McuFactorySipPort |
Opcional |
Inteiro |
Porta utilizada para se conectar ao Alocador de foco (McuFactory). O Alocador de foco aloca unidades de controle de mídia (MCUs) para adicionar tipos de mídia específicos (como áudio, por exemplo) às conferências. |
UserDatabase |
Opcional |
Cadeia de caracteres |
ID do serviço do banco de dados de usuários associado ao pool de Serviços do Usuário. Por exemplo: -UserDatabase "UserDatabase:atl-cs-001.litwareinc.com". |
Force |
Opcional |
Parâmetro de opção |
Suprime a exibição de qualquer mensagem de erro não-fatal que possa surgir durante a execução do comando. |
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-CsUserServer não aceita a entrada canalizada.
Tipos de Retorno
Set-CsUserServer não retorna qualquer objeto ou valor. Em vez disso, o cmdlet modifica instâncias existentes do objeto Microsoft.Rtc.Management.Xds.DisplayUserServer.
Exemplo
-------------------------- Exemplo 1 ------------------------
Set-CsUserServer -Identity "UserServer:atl-cs-001.litwareinc.com" -McuFactorySipPort 445
O comando exibido no Exemplo 1 altera o McuFactorySipPort para um único pool de Serviços do Usuário: o pool com a Identidade UserServer:atl-cs-001.litwareinc.com. Nesse exemplo, a porta é alterada para 445.
-------------------------- Exemplo 2 ------------------------
Get-CsService -UserServer | ForEach-Object {Set-CsUserServer -Identity $_.Identity -McuFactorySipPort 445}
O comando exibido no Exemplo 2 é uma variação do comando exibido no Exemplo 1. No entanto, nesse caso, McuFactorySipPort é modificado em todos os pools de Serviços do usuário na organização. Para isso, o comando usa primeiramente Get-CsService e o parâmetro UserServer, para retornar uma coleção de todos os pools de Serviços do usuário em uso. Essa coleção será então canalizada para o cmdlet ForEach-Object, que selecionará cada pool na coleção e definirá McuFactorySipPort como 445. Os dados deverão ser canalizados para ForEach-Object porque o cmdlet Set-CsUserServer não aceita dados canalizados.