Get-CsSipDomain
Tópico modificado em: 2012-03-23
Retorna as informações sobre os domínios SIP configurados para uso na 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
Get-CsSipDomain [-Identity <XdsGlobalRelativeIdentity>]
Get-CsSipDomain [-Filter <String>]
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.
O cmdlet Get-CsSipDomain oferece uma maneira para retornar informações sobre os domínios SIP autorizados para uso na sua organização. Get-CsSipDomain também identifica o domínio SIP padrão para sua organização; este é o domínio que o Microsoft Lync Server 2010 usará, por padrão, se um domínio SIP não for especificado.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-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 |
Opcional |
Cadeia de caracteres |
Nome do domínio totalmente qualificado do domínio SIP a ser retornado (por exemplo, fabrikam.com). Se nem esse parâmetro, nem o parâmetro Filter forem especificados, serão retornados todos os domínios SIP autorizados para o uso em sua organização. |
Filter |
Opcional |
Cadeia de caracteres |
Permite que você use curingas ao especificar as Identidades do domínio SIP (ou domínios) a serem retornadas. Por exemplo, o valor do filtro "*.org" retorna uma coleção de todos os domínios SIP autorizados que possuam uma Identidade que termine com o valor de cadeia de caracteres ".org". |
Tipos de Entrada
Nenhuma. Get-CsSipDomain não aceita dados em pipeline.
Tipos de Retorno
Get-CsSipDomain retorna instâncias do objeto Microsoft.Rtc.Management.Xds.SipDomain.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsSipDomain
No Exemplo 1, Get-CsSipDomain é chamado sem nenhum parâmetro; isso retorna informações sobre todos os domínios SIP configurados para uso em sua organização.
-------------------------- Exemplo 2 ------------------------
Get-CsSipDomain -Identity fabrikam.com
O comando exibido no Exemplo 2 retorna informações para qualquer domínio SIP que possua a Identidade fabrikam.com. Pela necessidade de as Identidades do domínio SIP serem exclusivas, este comando nunca retornará mais de apenas um item.
-------------------------- Exemplo 3 ------------------------
Get-CsSipDomain -Filter "f*"
O comando anterior usa Get-CsSipDomain e o parâmetro Filter para retornar informações sobre todos os domínios SIP que possuam uma Identidade que comece com a letra "f". Por exemplo: fabrikam.com; fabrikam.org; fabrikam-users.com; e assim por diante.
-------------------------- Exemplo 4 ------------------------
Get-CsSipDomain | Where-Object {$_.IsDefault -eq $True}
O comando exibido no Exemplo 4 retorna informações sobre o domínio SIP padrão. Para realizar isso, primeiramente chama-se Get-CsSipDomain sem nenhum parâmetro para que retorne uma coleção de todos os domínios SIP configurados em sua organização. Esta coleção será então canalizada para o cmdlet Where-Object, que selecionará o único domínio em que a propriedade IsDefault for igual a True.