New-CsSipDomain
Tópico modificado em: 2012-03-27
Cria um novo domínio SIP para uso em sua 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
New-CsSipDomain -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-IsDefault <$true | $false>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Para configurar endereços SIP para seus 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 seu Active Directory, autorizado a enviar e receber tráfego SIP. Por exemplo, suponha que você tenha domínios chamados litwareinc.com, fabrikam.com e contoso.com, mas apenas litwareinc.com tenha sido identificado como sendo um domínio SIP. Neste caso, não é 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 o cmdlet New-CsSipDomain.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-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 "New-CsSipDomain"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
Cadeia de caracteres |
O nome de domínio totalmente qualificado do novo domínio SIP. 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 também se tornará o novo domínio padrão O valor padrão para IsDefault é False. Caso não queira fazer do novo domínio o domínio padrão, basta deixar de fora o parâmetro. |
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. New-CsSipDomain não aceita dados em pipeline.
Tipos de Retorno
New-CsSipDomain cria novas instâncias do objeto Microsoft.Rtc.Management.Xds.SipDomain.
Exemplo
-------------------------- Exemplo 1 ------------------------
New-CsSipDomain -Identity fabrikam.com
O comando exibido no Exemplo 1 cria um novo domínio SIP com a Identidade fabrikam.com.
-------------------------- Exemplo 2 ------------------------
New-CsSipDomain -Identity fabrikam.com -IsDefault $True
O comando anterior cria um novo domínio SIP chamado fabrikam.com e torna esse novo domínio o domínio SIP padrão. Ao tornar fabrikam.com o domínio padrão, esse comando também "rebaixa" o domínio que serviu anteriormente como o domínio SIP padrão. Isso acontece porque só pode haver um único domínio SIP padrão.