New-CsSipProxyRealm
Tópico modificado em: 2012-03-27
Utilizado para atribuir o território padrão (SIP Communications Service) a uma coleção de definições de configuração de proxy. Os territórios (também conhecidos como domínios de proteção) são utilizados para autenticar credenciais de usuários durante o logon.
Sintaxe
New-CsSipProxyRealm -RealmChoice <IRealmChoice>
Descrição Detalhada
Os servidores proxy permitem aos usuários de fora da rede interna acessar os recursos da rede interna. Cada servidor proxy deve ser associado a um território; os territórios indicam onde devem ser processadas as credenciais de logon do usuário. Por padrão, o Microsoft Lync Server 2010 utiliza o SIP Communications Server como seu território padrão. No entanto, é possível alterar o território utilizado por um servidor proxy. Os cmdlets New-CsSipProxyUseDefault e New-CsSipProxyCustom permitem alterar o território usado por um servidor proxy. Essas alterações também podem ser feitas utilizando-se New-CsSipProxyRealm. No entanto, como esse cmdlet exige uma etapa adicional, é possível utilizar os outros dois cmdlets sempre que se precisar alterar o território utilizado por um servidor proxy.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-CsSipProxyRealm 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 "New-CsSipProxyRealm"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
RealmChoice |
Obrigatório |
Objeto SipProxy.IRealmChoice |
Objeto que representa o território a ser utilizado por um servidor proxy. RealmChoice deve ser criado utilizando-se o cmdlet New-CsSipProxyUseDefault ou New-CsSipProxyCustom. |
Tipos de Entrada
Nenhuma. New-CsSipProxyRealm não aceita a entrada canalizada.
Tipos de Retorno
New-CsSipProxyRealm cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Realm.
Exemplo
-------------------------- Exemplo 1 ------------------------
$x = New-CsSipProxyUseDefault
$y = New-CsSipProxyRealm -RealmChoice $x
Os comandos exibidos no Exemplo 1 atribuem o território padrão (SIP Communications Service) a uma variável denominada $y. Para isso, o primeiro comando chama New-CsSipProxyUseDefault para criar um objeto SipProxy.UseDefault. Esse objeto é armazenado em uma variável denominada $x.
No segundo comando, utiliza-se $x como valor de parâmetro de New-CsSipProxyRealm e o parâmetro RealmChoice. Por sua vez, isso cria um novo objeto de território de proxy, que é armazenado em uma variável denominada $y.
-------------------------- Exemplo 2 ------------------------
$x = New-CsSipProxyCustom -CustomValue "Litwareinc Communications Service"
$y = New-CsSipProxyRealm -RealmChoice $x
Os comandos exibidos no Exemplo 2 atribuem um território personalizado (Litwareinc Communications Service) a uma variável denominada $y. Para isso, o primeiro comando chama New-CsSipProxyCustom, para criar um objeto SipProxy.Custom. Esse objeto (que usa CustomValue Litwareinc Communications Service) é armazenado em uma variável denominada $x.
No segundo comando, utiliza-se $x, juntamente com o cmdlet New-CsSipProxyRealm e o parâmetro RealmChoice, para criar um novo objeto de território personalizado.