Remove-CsSipDomain
Tópico modificado em: 2012-03-27
Remove um domínio SIP configurado anteriormente para uso 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
Remove-CsSipDomain -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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.
Depois que um domínio SIP tiver sido autorizado, ele poderá se tornar "não autorizado", mediante o uso do cmdlet Remove-CsSipDomain. Esse cmdlet remove o domínio especificado da lista de domínios SIP aprovados. No entanto, observe que não é possível remover o domínio padrão; se precisar fazer isso, será necessário primeiro configurar um outro domínio SIP, que atuará como domínio padrão. Se houver apenas um domínio SIP, ele será configurado automaticamente como domínio padrão e não será possível removê-lo.
Além disso, não é possível remover qualquer domínio SIP que tenha um ou mais endereços SIP atribuídos a ele. Por exemplo: não é possível remover Contoso.com como um domínio SIP se Ken Myer tiver o endereço SIP "sip:kenmyer@contoso.com". Para remover um domínio SIP em uso no momento, é necessário primeiramente atribuir novos endereços SIP a todos os usuários cujo endereço SIP contiver este domínio.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-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 "Remove-CsSipDomain"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
Cadeia de caracteres |
Nome totalmente qualificado (FQDN) do domínio SIP a ser removido: Por exemplo: -Identity fabrikam.com. |
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
Objeto Microsoft.Rtc.Management.Xds.SipDomain. Remove-CsSipDomain aceita instâncias canalizadas do objeto de domínio SIP.
Tipos de Retorno
Nenhuma. Em vez disso, Remove-CsSipDomain exclui a instância existente do objeto Microsoft.Rtc.Management.Xds.SipDomain.
Exemplo
-------------------------- Exemplo 1 ------------------------
Remove-CsSipDomain -Identity fabrikam.com
O comando anterior remove o domínio SIP cuja Identidade for fabrikam.com da lista de nomes de domínios suportados. Observe que esse comando falhará se fabrikam.com for o único domínio SIP em uso na organização. Isso ocorrerá porque a topologia deve incluir, pelo menos, um domínio SIP.
-------------------------- Exemplo 2 ------------------------
Get-CsSipDomain | Where-Object {$_.IsDefault -ne $True} | Remove-CsSipDomain
O comando exibido no Exemplo 2 exclui todos os domínios SIP na organização, exceto o domínio padrão. Para isso, o comando primeiramente chama Get-CsSipDomain, para retornar uma coleção de todos os domínios SIP. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas os domínios cuja propriedade IsDefault não for igual a True. O resultado: o domínio padrão será filtrado e os domínios restantes serão canalizados para Remove-CsSipDomain e excluídos.