Compartilhar via

  • Artigo

Get-CsConferenceDirectory

 

Tópico modificado em: 2012-03-23

Retorna informações sobre os diretórios de conferências configurados para uso na organização. Os diretórios de conferência são usados para ajudar usuários de conferência discada a localizar informações de conferência.

Sintaxe

Get-CsConferenceDirectory [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsConferenceDirectory [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

Quando você cria um URI de conferência discada, esses URIs recebem endereços SIP exclusivos. No entanto, é difícil traduzir endereços SIP em dispositivos sem reconhecimento de SIP; por exemplo, um telefone da PSTN (rede telefônica pública comutada) não pode traduzir um endereço SIP. Por isso, o Microsoft Lync Server 2010 usa diretórios de conferências como uma forma de ajudar esses dispositivos a localizar e a se conectar a conferências discadas. Isso é feito criando-se um diretório de conferências SIP associado a cada URI de conferência discada e identificado por um valor inteiro diferente de um URI SIP. Assim, telefones PSTN e outros dispositivos podem usar esses números (em vez de um URI SIP) ao se conectarem a conferências; o número do diretório é incluído na identificação da conferência PSTN inserida pelos usuários durante a conexão com uma conferência discada.

O cmdlet Get-CsConferenceDirectory permite retornar informações sobre todos os diretórios de conferências configurados para uso na organização.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsConferenceDirectory localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsConferenceDirectory"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Xds Identity

Identificador numérico (por exemplo, 7) do diretório de conferências a ser retornado. Se esse parâmetro for omitido, Get-CsConferenceDirectory retornará informações sobre todos os diretórios de conferências em uso na organização.

Filter

Opcional

Cadeia de caracteres

Permite usar curingas para especificar a Identity do diretório de conferências (ou diretórios) a ser retornado. Como as Identidades de diretório são numéricas, esse parâmetro pode ter um valor mínimo. No entanto, essa sintaxe retornará todos os diretórios de conferências com uma Identity que comece com o número 3: -Filter "3*".

LocalStore

Opcional

Parâmetros de opção

Obtém os dados de diretório de conferência a partir da réplica local do Repositório de Gerenciamento Central, e não do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsConferenceDirectory não aceita entrada em pipeline.

Tipos de Retorno

Get-CsConferenceDirectory retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.PstnConf.ConferenceDirectories.

Exemplo

-------------------------- Exemplo 1 ------------------------

Get-CsConferenceDirectory

O comando mostrado no Exemplo 1 retorna informações sobre todos os diretórios de conferências configurados para uso na organização.

-------------------------- Exemplo 2 ------------------------

Get-CsConferenceDirectory -Identity 2

O Exemplo 2 retorna informações sobre o diretório de conferências com a Identity 2. Como as identidades devem ser exclusivas, o comando jamais retornará mais de um diretório de conferências único.

-------------------------- Exemplo 3 ------------------------

Get-CsConferenceDirectory | Where-Object {$_.ServiceID -match "UserServer:atl-cs-001.litwareinc.com"}

O comando anterior retorna todos os diretórios de conferências hospedados no serviço UserServer:atl-cs-001.litwareinc.com. Para isso, o comando chama inicialmente Get-CsConferenceDirectory sem nenhum parâmetro para retornar uma coleção de todos os diretórios de conferências encontrados na organização. Em seguida, essa coleção é redirecionada para o cmdlet Where-Object, que só seleciona os diretórios nos quais ServiceID corresponda ao valor de cadeia de caracteres "UserServer:atl-cs-001.litwareinc.com".