Compartilhar via

  • Artigo

Get-CsDialInConferencingAccessNumber

 

Tópico modificado em: 2012-03-23

Retorna informações sobre todos os números de acesso à conferência discada configurados para uso na organização. As conferências discadas permitem aos usuários usar um telefone"comum", telefone celular ou outro dispositivo da Rede telefônica pública comutada (PSTN) para participar da parte de áudio de uma conferência.

Sintaxe

Get-CsDialInConferencingAccessNumber [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]

Get-CsDialInConferencingAccessNumber [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-Region <String>] [-ResultSize <Unlimited>]

Get-CsDialInConferencingAccessNumber -EmptyRegion <SwitchParameter> [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-OU <OUIdParameter>] [-ResultSize <Unlimited>]

Descrição Detalhada

As conferências discadas permitem que os usuários usem qualquer tipo de telefone (como uma linha fixa padrão, um telefone celular, um telefone VoIP) para participar da parte de áudio de uma conferência online. Isso permite que os usuários participem da reunião mesmo se não possuírem um computador ou uma conexão à Internet. Os usuários possuem recursos completos de áudio: eles podem falar com outros participantes e ouvir tudo o que acontece. No entanto, eles não poderão ver os slides compartilhados, as transmissões de vídeo ou outros elementos visuais.

Para oferecer aos usuários recursos de conferência discada, é necessário criar números de acesso a conferências discadas: os números de telefone que os usuário poderão ligar para se conectar à reunião. Os números de acesso a conferências discadas são criados usando-se o cmdlet New-CsDialInConferencingAccessNumber. Na realidade, ao criar um novo número de acesso a conferências discadas, você estará criando um novo objeto de contato no Serviços de Domínio Active Directory (AD DS); esse objeto de contato é usado para representar o número de acesso e todas as suas propriedades. Os números de contato podem ser recuperados utilizando-se o cmdlet Get-CsDialInConferencingAccessNumber.

Se você tiver importado números de acesso a conferências discadas do Microsoft Office Communications Server 2007, esses números também serão recuperados executando-se Get-CsDialInConferencingAccessNumber e incluindo-se o parâmetro Region. (os números importados não serão exibidos, a menos que você use o parâmetro Region). No entanto, observe que uma mensagem de aviso será exibida juntamente com os Identificadores de recursos uniformes (URIs) do número importado. Essa é apenas uma maneira como o cmdlet gerencia os números importados de acesso a conferências discadas.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsDialInConferencingAccessNumber localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins e RTCUniversalReadOnlyAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Endereço SIP

Endereço SIP do número de acesso à conferência discada (ou seja, o objeto de contato que representa o número) a ser recuperado. É necessário incluir o prefixo "sip:" ao se especificar a Identidade. Por exemplo: -Identity sip:RedmondDialIn@litwareinc.com.

Se esse parâmetro não for especificado, Get-CsDialInConferencingAccessNumber retornará todos os números de acesso a conferências discadas configurados para uso na organização.

Credential

Opcional

Objeto PS Credential

Permite executar o cmdlet Get-CsDialInConferencingAccessNumber com credenciais alternativas. Isso pode ser necessário se a conta que você tiver utilizado para fazer o logon no Windows não tiver os privilégios necessários para trabalhar com os objetos de contato.

Para usar o parâmetro Credential, crie primeiramente um objeto PSCredential, usando o cmdlet Get-Credential. Para detalhes, consulte o tópico de Ajuda Get-Credential.

DomainController

Opcional

Cadeia de caracteres

Permite que você se conecte a um controlador de domínio especificado, para recuperar as informações de contato. Para se conectar a um determinado controlador de domínio, inclua o parâmetro DomainController, seguido do nome de computador (atl-mcs-001, por exemplo) ou do seu nome de domínio totalmente qualificado (atl-mcs-001.litwareinc.com, por exemplo).

EmptyRegion

Opcional

Parâmetro de opção

Retorna informações sobre os planos de discagem que estão associados a uma região que não esteja associada a, pelo menos, um número de acesso à conferência discada. Por exemplo: suponha que o plano de discagem Bellevue esteja associado à região Bellevue, mas nenhum número de acesso tenha sido configurado para esta região. A região de Bellevue seria então considerada uma região vazia.

Este parâmetro não pode ser usado juntamente com outro parâmetro.

Filter

Opcional

Cadeia de caracteres

Permite limitar os dados retornados pela filtragem de atributos específicos a Microsoft Lync Server 2010. Por exemplo, é possível limitar os dados retornados aos números de conferência discada que possuírem o valor de cadeia de caracteres "Redmond" em seu nome de exibição, ou aos números de conferência discada gratuita que utilizarem o prefixo 1-800.

O parâmetro Filter usa a mesma sintaxe de filtragem do Windows PowerShell utilizada pelo cmdlet Where-Object. Por exemplo: um filtro que retorna apenas os números de acesso que possuírem o prefixo 1-800 teria a seguinte aparência: {LineUri -like "tel:+1800*"}, onde LineUri representa o atributo do Active Directory, -like, o operador de comparação e "tel:+1800*", o valor do filtro.

OU

Opcional

Cadeia de caracteres

Permite retornar números de acesso de uma unidade organizacional (OU) específica do Active Directory. Isto inclui dados da OU especificada e de qualquer uma de suas OUs filhas. Por exemplo: se a OU Financeiro tiver duas OUs filhas (AccountsPayable e AccountsReceivable), serão retornados números de acesso correspondentes a cada uma dessas três OUs.

Ao se especificar uma OU, utilize o nome diferenciado do contêiner. Por exemplo: -OU "OU=Finance,dc=litwareinc,dc=com".

Region

Opcional

Cadeia de caracteres

Retorna todos os números de acesso à conferência discada associados à região do plano de discagem especificado. Por exemplo, para retornar todos os números discados para a região noroeste, utilize esta sintaxe: -Region Northwest.

Também é possível retornar números de acesso que foram estendidos a um determinado site (ou ao escopo global), incluindo-se o escopo no valor do parâmetro. Por exemplo: para retornar os números de acesso que usam a região Northwest e que foram estendidos para o site de Redmond, utilize essa sintaxe: -Region site:Redmond/Northwest. Observe que, ao fazer referência ao escopo de site, é necessário usar a propriedade SiteId. É possível recuperar os valores de SiteId utilizando-se o cmdlet Get-CsSite.

Para retornar uma lista de números de acesso que não estiverem associados a um plano de discagem, defina o parâmetro Region como $Null: -Region $Null.

Observe que os números de acesso a conferências discadas serão retornados na ordem de sua prioridade atribuída apenas se esse parâmetro for especificado. A ordem de prioridade é a mesma ordem em que os números aparecem em convites de reunião e na página da web de conferências discadas. Para obter mais detalhes, consulte o tópico da Ajuda Set-CsDialInConferencingAccessNumber.

ResultSize

Opcional

Inteiro

Permite limitar o número de registros retornados por um comando. Por exemplo: para retornar somente sete números de acesso (independentemente de quantos números de acesso houver na floresta), basta incluir o parâmetro ResultSize e definir o valor de parâmetro como 7. Observe que não há como garantir quais sete itens serão retornados. Se você estabelecer ResultSize como sendo 7, mas só houver três números de acesso na floresta, o comando retornará os três números e, em seguida, concluirá sem erro.

O tamanho dos resultados pode ser definido como qualquer número inteiro entre 0 e 2147483647, inclusive. Se o número for definido como 0, o comando será executado, mas nenhum dado será retornado.

Tipos de Entrada

Cadeia de caracteres. Get-CsDialInConferencingAccessNumber aceita um valor de cadeia de caracteres que representa a Identidade do número de acesso.

Tipos de Retorno

Get-CsDialInConferencingAccessNumber retorna instâncias do objeto Microsoft.Rtc.Management.Xds.AccessNumber.

Exemplo

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

Get-CsDialInConferencingAccessNumber

O comando apresentado no Exemplo 1 retorna uma coleção de todos os números de acesso à conferência discada configurados para uso na organização. O ato de chamar Get-CsDialInConferencingAccessNumber sem nenhum parâmetro adicional sempre retornará uma coleção de todos os números de acesso discado disponíveis.

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

Get-CsDialInConferencingAccessNumber -Identity sip:RedmondDialIn@litwareinc.com

No Exemplo 2, será retornado o número de acesso à conferência discada com a Identidade sip:RedmondDialIn@litwareinc.com. Como as identidades devem ser exclusivas, este comando nunca retornará mais do que um número de acesso.

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

Get-CsDialInConferencingAccessNumber -Region "Redmond"

O Exemplo 3 usa o parâmetro Region para retornar todos os números de acesso a conferências discadas associados à região Redmond. Para isso, chama-se Get-CsDialInConferencingAccessNumber, juntamente com o parâmetro Region. A especificação do valor do parâmetro "Redmond" faz com que Get-CsDialInConferencingAccessNumber retorne todos os números nos quais "Redmond" apareça na lista de regiões associadas. Por exemplo: será retornado um número de acesso que listar Redmond apenas como região, assim como um número de acesso que listar Redmond e Portland.

-------------------------- Exemplo 4 ------------------------

Get-CsDialInConferencingAccessNumber -Region $Null

O comando anterior retorna todos os números de acesso a conferências discadas que não estiverem associados a uma região (ou seja, a propriedade Regions estará vazia).

-------------------------- Exemplo 5 ------------------------

Get-CsDialInConferencingAccessNumber -Region site:USA/Redmond

O comando exibido no Exemplo 5 retorna todos os números de acesso a conferências discadas para a região Redmond que foram estendidos ao site USA (ou seja, o site com o SiteId site:USA).

-------------------------- Exemplo 6 ------------------------

Get-CsDialInConferencingAccessNumber -Filter {DisplayName -like "*Seattle*"}

No Exemplo 6, utiliza-se o parâmetro Filter, para retornar uma coleção de todos os números de acesso a conferências discadas que incluírem o valor de cadeia de caracteres "Seatle" em alguma posição de DisplayName. O valor de filtro {DisplayName -like "*Seattle*"} limita os dados retornados aos números de acesso nos quais DisplayName incluir a palavra "Seattle" (Seattle Access Number, Dial-In Number for Seattle, Tacoma/Seattle Access Number, etc., por exemplo).

-------------------------- Exemplo 7 ------------------------

Get-CsDialInConferencingAccessNumber -Filter {LineUri -like "tel:+1425*"}

O Exemplo 7 retorna todos os números de acesso a conferências discadas nos quais o URI da linha comece com +1425. Isso retorna efetivamente todos os números de acesso norte-americanos cujo código de área for 425. Para isso, chama-se Get-CsDialInConferencingAccessNumber, juntamente com o parâmetro Filter. O valor de filtro {LineUri -like "tel:+1425*"} limita os dados retornados aos URIs de linha que começarem com o valor de cadeia de caracteres "tel:+1425". Para retornar todos os números de telefone correspondentes aos códigos de área 425 ou 426, utilize esse valor de filtro:

{LineUri -like "tel:+1425*" -or LineUri -like "tel:+1206*"}

-------------------------- Exemplo 8 ------------------------

Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -eq "it-IT"}

O exemplo anterior retorna uma coleção de todos os números de acesso à conferência discada nos quais o idioma principal estiver definido como Italiano. Para realizar essa tarefa, chama-se inicialmente Get-CsDialInConferencingAccessNumber, para retornar uma coleção de todos os números de acesso configurados para uso na organização. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas os números cuja propriedade PrimaryLanguage for igual a Italiano ("it-It").

-------------------------- Exemplo 9 ------------------------

Get-CsDialInConferencingAccessNumber  | Where-Object {$_.SecondaryLanguages -contains "fr-FR"}

O comando exibido no Exemplo 9 retorna todos os números de acesso a conferências discadas nos quais Francês estiver listado como um dos idiomas secundários. Para realizar essa tarefa, chama-se inicialmente Get-CsDialInConferencingAccessNumber, sem qualquer parâmetro. Isso retornará uma coleção completa de números de acesso configurados para uso na organização. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas os números cuja propriedade SecondaryLanguages incluir a listagem do idioma francês (fr-FR).