Compartilhar via


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.

Consulte Também

Outros Recursos

Get-CsService