Compartilhar via

  • Artigo

New-CsDialInConferencingAccessNumber

 

Tópico modificado em: 2012-03-23

Cria um novo número de acesso de conferência discada. A conferência discada permite 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

New-CsDialInConferencingAccessNumber -DisplayNumber <String> -LineURI <String> -Pool <Fqdn> -PrimaryLanguage <String> -PrimaryUri <String> -Regions <MultiValuedProperty> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-PassThru <SwitchParameter>] [-ScopeToSite <SwitchParameter>] [-SecondaryLanguages <MultiValuedProperty>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

A conferência discada permite que os usuários usem qualquer tipo de telefone (como uma linha fixa padrão, um telefone celular, um telefone VoIP, etc.) para participar da parte de áudio de uma conferência. 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. Eles só não poderão ver slides compartilhados, 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 usuários de números de telefone 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.

Ao criar um novo número de discagem, será necessário incluir os seguintes parâmetros: PrimaryUri, LineURI, Pool, DisplayNumber, PrimaryLanguage e Regions. Todos esses parâmetros (e seus respectivos valores) são razoavelmente objetivos, com talvez uma exceção: Regions. Quando se cria um novo número de acesso, esse número deve ser associado a uma ou várias regiões. Por sua vez, uma região não pode ser associada a um número de conferência discada, a menos que essa região apareça em, pelo menos, um plano de discagem. Se uma região constar da propriedade DialInConferencingRegion de pelo menos um plano de discagem, ela poderá ser associada a um número de acesso. Se não constar, ela não poderá ser associada a um número de acesso. Isso significa simplesmente que será necessário primeiramente criar um plano de discagem e especificar uma região para esse plano de discagem, antes de criar um número 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 New-CsDialInConferencingAccessNumber 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-CsDialInConferencingAccessNumber"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

PrimaryUri

Obrigatório

Endereço SIP

Endereço SIP exclusivo a ser atribuído ao novo objeto de contato. Ao se especificar o PrimaryUri, é necessário incluir o prefixo "sip:". Por exemplo: -PrimaryUri "sip:RedmondDialIn@litwareinc.com".

DisplayName

Opcional

Cadeia de caracteres

Nome de exibição do novo objeto de contato no Active Directory. Esse é o nome que será exibido no Microsoft Lync 2010.

DisplayNumber

Obrigatório

Cadeia de caracteres

O número de telefone, como é exibido nos convites de reunião e na página da web da conferência discada. DisplayNumber pode ser formatado de qualquer maneira. Por exemplo: 1-800-555-1234, 1-(800)-555-1234 ou 1.800.555.1234.

LineURI

Obrigatório

Cadeia de caracteres

o número de telefone real da conferência discada. LineUri deve ser especificado usando-se a seguinte sintaxe: o prefixo tel: seguido de um sinal de adição (+), do código de chamada do país/região, do código de área e do número do telefone. Por exemplo: tel:+18005551234. Observe que não são permitidos espaços, hífens, parênteses ou outros caracteres.

LineURIs deve ser exclusivo em todo o Active Directory.

Regions

Obrigatório

Cadeia de caracteres

Regiões de plano de discagem associadas ao número de discagem. Se uma região não for incluída em pelo menos um plano de discagem, ela não poderá ser associada a um número de acesso de conferências discadas. Para especificar diversas regiões, use uma lista separada por vírgulas: -Regions "Noroeste", "Sudoeste"

Pool

Obrigatório

FQDN

O pool inicial do novo objeto de contato.

PrimaryLanguage

Obrigatório

Cadeia de caracteres

O idioma principal usado para fazer comunicados em conferências discadas. O idioma deve ser configurado usando-se um dos códigos de idioma de conferências discadas disponíveis. Por exemplo, en-US, para inglês dos EUA, fr-FR, para francês, etc. Para retornar uma lista dos códigos de idioma disponíveis, digite o seguinte comando no prompt do Windows PowerShell:

Get-CsDialInConferencingLanguageList | Select-Object -ExpandProperty Languages.

SecondaryLanguages

Opcional

Matriz de cadeias de caracteres

Coleção opcional de idiomas que também podem ser usados para fazer comunicados em conferências discadas. Os idiomas secundários devem ser configurados como uma lista separada por vírgulas dos códigos de idioma. Por exemplo, a sintaxe a seguir define francês canadense e francês como idiomas secundários: -SecondaryLanguages "fr-CA", "fr-FR".

Um único número de acesso pode ter até quatro idiomas secundários.

ScopeToSite

Opcional

Parâmetro de opção

Se houver, o novo número será estendido para o mesmo site que o pool inicial do objeto de contato. Se o parâmetro ScopeToSite não for incluído, o novo número será atribuído ao escopo global.

PassThru

Opcional

Parâmetro de opção

Permite passar um objeto de contato através do pipeline que representa o novo número de acesso à conferência discada. Por padrão, o cmdlet New-CsDialInConferencingAccessNumber não canaliza objetos.

Tenant

Opcional

Guid

Este parâmetro não se aplica à versão local do Lync Server 2010.

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-CsDialInConferencingAccessNumber não aceita a entrada canalizada.

Tipos de Retorno

New-CsDialInConferencingAccessNumber cria novas instâncias do objeto Microsoft.Rtc.Management.Xds.AccessNumber.

Exemplo

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

New-CsDialInConferencingAccessNumber -PrimaryUri "sip:RedmondDialIn@litwareinc.com" -DisplayNumber "1-800-555-1234" -LineUri "tel:+18005551234" -Pool atl-cs-001.litwareinc.com -PrimaryLanguage "en-US" -Regions "Redmond"

O Exemplo 1 cria um novo número de acesso a conferências discadas com o URI primário sip:RedmondDialIn@litwareinc.com. Além do parâmetro PrimaryUri, o comando também inclui parâmetros que configuram o número de telefone, como exibido no Microsoft Lync 2010 (DisplayNumber), o número do telefone no formato E.164 (LineUri), o pool de Registrador ao qual o novo número é atribuído (-Pool): o idioma principal do número (PrimaryLanguage) e a região à qual o novo número é atribuído (Regions).

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

New-CsDialInConferencingAccessNumber -PrimaryUri "sip:RedmondDialIn@litwareinc.com" -DisplayNumber "1-800-555-1234" -LineUri "tel:+18005551234" -Pool atl-cs-001.litwareinc.com -PrimaryLanguage "en-US" -Regions "Redmond" -SecondaryLanguages "fr-CA", "fr-FR"

O comando exibido no Exemplo 2 é uma variação do comando exibido no Exemplo 1; a única diferença é que o comando exibido nesse exemplo também atribui dois idiomas secundários (francês canadense e francês) ao novo número de acesso à conferência discada. Para se atribuir esses idiomas secundários, inclui-se o parâmetro SecondaryLanguages, juntamente com uma lista separada por vírgulas dos idiomas a serem atribuídos (fr-CA e fr-FR).

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

New-CsDialInConferencingAccessNumber -PrimaryUri "sip:RedmondDialIn@litwareinc.com" -DisplayNumber "1-800-555-1234" -LineUri "tel:+18005551234" -Pool atl-cs-001.litwareinc.com -PrimaryLanguage "en-US" -Regions "Redmond" -ScopeToSite

O comando anterior cria um novo número de acesso à conferência discada que foi estendida ao site no qual está localizado o pool inicial do objeto de contato. Para isso, o comando inclui o parâmetro ScopeToSite.