Set-CsSipDomain
Tópico modificado em: 2012-03-27
Permite a modificação dos valores de propriedades de domínios SIP na organização. Os domínios SIP são domínios autorizados a enviar e receber tráfego SIP, e são usados ao atribuir endereços SIP a usuários.
Sintaxe
Set-CsSipDomain [-Identity <XdsGlobalRelativeIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-IsDefault <$true | $false>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Para configurar os endereços SIP dos usuários (e, consequentemente, permitir que eles usem programas de software relacionado ao SIP, como Microsoft Lync 2010), são necessárias duas informações: um ID de usuário (por exemplo, Ken.Myer) e um domínio SIP (por exemplo, litwareinc.com). O domínio SIP usado para constituir um endereço SIP deve ser um domínio, localizado dentro da floresta do Active Directory, autorizado a enviar e receber tráfego SIP. Por exemplo: suponha que haja domínios denominados litwareinc.com, fabrikam.com e contoso.com, mas apenas litwareinc.com tenha sido identificado como sendo um domínio SIP. Neste caso, não será possível usar um endereço SIP como sip:Ken.Myer@fabrikam.com ou sip:Ken.Myer@contoso.com, pelo menos enquanto fabrikam.com e contoso.com não tiverem sido configurados como domínios SIP válidos. Isso pode ser feito executando-se o cmdlet New-CsSipDomain.
É necessário haver sempre um domíno SIP configurado no domínio padrão. O cmdlet Set-CsSipDomain permite alterar o domínio SIP padrão.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsSipDomain 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 (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsSipDomain"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
Cadeia de caracteres |
Nome de domínio totalmente qualificado (FQDN) do domínio SIP a ser configurado como o domínio padrão. Por exemplo: -Identity fabrikam.com. |
IsDefault |
Opcional |
Booleano |
Indica se o domínio é o domínio SIP padrão, usado pelo Lync Server 2010 sempre que um nome de domínio não for declarado explicitamente. Se for definido como True, o novo domínio se tornará o novo domínio padrão. Não é possível definir esse valor como False porque isso o deixaria sem um domínio SIP padrão. |
Force |
Opcional |
Parâmetro de opção |
Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer 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-CsSipDomain não aceita dados canalizados.
Tipos de Retorno
Set-CsSipDomain não retorna qualquer objeto ou valor. Em vez disso, o cmdlet é usado para modificar instâncias existentes do objeto Microsoft.Rtc.Management.Xds.SipDomain.
Exemplo
-------------------------- Exemplo 1 ------------------------
Set-CsSipDomain -Identity fabrikam.com -IsDefault $True
O comando mostrado no Exemplo 1 faz do domínio SIP fabrikam.com o domínio SIP padrão, graças ao uso do parâmetro–IsDefault e do valor de parâmetro $True. Quando se executa o comando, Fabrikam.com se torna o domínio padrão e o domínio que era o padrão anterior é "rebaixado". Isso acontece porque só pode haver um único domínio padrão.