Set-CsDirector
Tópico modificado em: 2012-03-27
Modifica as propriedades de um ou mais Diretores. Os Diretores podem ser usados para autenticar solicitações de usuário, mas não hospedar contas de usuário.
Sintaxe
Set-CsDirector [-Identity <XdsGlobalRelativeIdentity>] [-ArchivingServer <String>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-Force <SwitchParameter>] [-MonitoringServer <String>] [-SipHealthPort <UInt16>] [-SipPort <UInt16>] [-SipServerTcpPort <UInt16>] [-WebPort <UInt16>] [-WebServer <String>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
O Diretor autentica usuários e atende a solicitações de usuário sem efetivamente hospedar contas de usuário. Os Diretores costumam ser usados para organizações que permitem o acesso externo à rede por meio dos Servidores de Borda. Nesse cenário, os Diretores não apenas ajudam a diminuir a carga em Servidores Front End (tratando solicitações de autenticação), como também ajudam a proteger a rede interna de ataques de negação de serviço e outro tráfego mal-intencionado. Os Diretores também são úteis sempre que vários Servidores Front End são implantados em um site central. Nesse caso, os Diretores receberão todas as solicitações de usuário e, em seguida, canalizarão essas solicitações para o pool de servidores apropriado. Isso, mais uma vez, ajuda a diminuir a carga sobre os Servidores Front End.
O cmdlet Set-CsDirector permite modificar os valores de propriedade de qualquer um dos Diretores atualmente em uso na organização. Isso inclui a alteração de coisas como o Servidor de Arquivamento ou o Servidor de Borda associado ao Diretor, ou a alteração da porta usada no envio e no recebimento do tráfego SIP.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsDirector localmente: RTCUniversalServerAdmins. 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 "Set-CsDirector"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
Xds Identity |
Local do serviço do Diretor a ser modificado. Por exemplo: -Identity "Director:atl-cs-001.litwareinc.com". Observe que o prefixo "Director:" pode ser deixado de fora ao especificar um Diretor. Por exemplo: -Identity "atl-cs-001.litwareinc.com". |
ArchivingServer |
Opcional |
Cadeia de caracteres |
Local de serviço do Servidor de Arquivamento a ser associado ao Diretor. Por exemplo: -ArchivingServer "ArchivingServer:atl-cs-001.litwareinc.com". |
EdgeServer |
Opcional |
Cadeia de caracteres |
Local de serviço do Servidor de Borda a ser associado ao Diretor. Por exemplo: -EdgeServer "EdgeServer:atl-edge-001.litwareinc.com" |
MonitoringServer |
Opcional |
Cadeia de caracteres |
Local de serviço do Servidor de Monitoramento a ser associado ao Diretor. Por exemplo: -MonitoringServer "MonitoringServer:atl-cs-001.litwareinc.com". |
SipPort |
Opcional |
Inteiro |
Porta usada para o tráfego do protocolo SIP. |
SipHealthPort |
Opcional |
Inteiro |
Porta usada para o monitoramento da integridade do servidor. |
SipServerTcpPort |
Opcional |
Inteiro |
Porta de escuta SIP. O valor padrão é 5060. |
WebPort |
Opcional |
Inteiro |
Porta usada para a comunicação com o Serviços Web. |
WebServer |
Opcional |
Cadeia de caracteres |
Local de servidor do Serviços Web a ser associado ao Diretor. Por exemplo: -WebServer "WebServer:atl-cs-001.litwareinc.com" |
Force |
Opcional |
Parâmetros de opção |
Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando. |
WhatIf |
Opcional |
Parâmetros de opção |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
Parâmetros de opção |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Nenhuma. Set-CsDirector não aceita entrada em pipeline.
Tipos de Retorno
Set-CsDirector não retorna nenhum objeto ou valor. Em vez disso, o cmdlet modifica instâncias existentes do objeto Microsoft.Rtc.Management.Xds.DisplayDirector.
Exemplo
-------------------------- Exemplo 1 ------------------------
Set-CsDirector -Identity "Director:atl-cs-001.litwareinc.com" -ArchivingServer "ArchivingServer:dublin-cs-001.litwareinc.com"
O comando mostrado no Exemplo 1 altera o Servidor de Arquivamento associado ao Diretor Director:atl-cs-001.litwareinc.com. Neste exemplo, o Servidor de Arquivamento é alternado para ArchivingServer:dublin-cs-001.litwareinc.com.
-------------------------- Exemplo 2 ------------------------
Get-CsService -Director | ForEach-Object {Set-CsDirector -Identity $_.Identity -SipPort 5072}
O comando anterior altera a porta SIP para todos os Diretores atualmente em uso na organização. Para fazer isso, o comando usa inicialmente Get-CsService e o parâmetro Director para retornar uma coleção de todos os Diretores na organização. Esta coleção é então canalizada para ForEach-Object. Por sua vez, ForEach-Object executa Set-CsDirector em cada site da coleção, alterando o valor da propriedade SipPort para 5072.