Set-CsDialInConferencingAccessNumber
Tópico modificado em: 2012-03-27
Modifica os valores da propriedade de um número de acesso de conferência discada existente. A conferência discada oferece uma maneira de usuários ingressarem na porção de áudio de uma conferência utilizando telefones e celulares "comuns e outros dispositivos na PSTN (rede telefônica pública comutada).
Sintaxe
Set-CsDialInConferencingAccessNumber -Instance <AccessNumber> [-Confirm [<SwitchParameter>]] [-PassThru <SwitchParameter>] [-ScopeToGlobal <SwitchParameter>] [-ScopeToSite <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Set-CsDialInConferencingAccessNumber -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-LineUri <String>] [-PassThru <SwitchParameter>] [-PrimaryLanguage <String>] [-Regions <MultiValuedProperty>] [-ScopeToGlobal <SwitchParameter>] [-ScopeToSite <SwitchParameter>] [-SecondaryLanguages <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]
Set-CsDialInConferencingAccessNumber -Identity <UserIdParameter> -Priority <Int32> -ReorderedRegion <String> [-Confirm [<SwitchParameter>]] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
A conferência discada permite que os usuários utilizem qualquer tipo de telefone (por exemplo, uma "linha terrestre" comum, um telefone celular, um telefone VoIP) para ingressar na parte de áudio de uma conferência. Isso permite aos usuários participar da reunião mesmo que não tenham um computador ou uma conexão com a Internet. Os usuários discados têm recursos de áudio completos: eles poderão conversar com outros participantes e ouvir tudo; só não poderão ver slides compartilhados, transmissões de vídeo ou outros elementos visuais.
Para fornecer aos usuários recursos de conferência discada, você deve criar números de acesso de conferência discada: os usuários de números de telefone podem ligar para se conectar a uma reunião. Os números de acesso da conferência discada são criados usando-se o cmdlet New-CsDialInConferencingAccessNumber. Ao criar um novo número de acesso de conferência discada, você efetivamente cria 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.
Após a criação de um número de conferência discada, é possível usar o cmdlet Set-CsDialInConferencingAccessNumber para modificar as propriedades desse número. Por exemplo, é possível alterar configurações como o próprio número de telefone (LineUri), ou o nome para exibição do objeto de contato que representa esse número. Além disso, Set-CsDialInConferencingAccessNumber permite modificar o escopo do número; por exemplo, é possível usar esse cmdlet para usar um número atribuído ao escopo global e reatribuí-lo ao escopo do site.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsDialInConferencingAccessNumber localmente: 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 "Set-CsDialInConferencingAccessNumber"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
Endereço SIP |
O endereço SIP do objeto de contato que representa o número de conferência discada. Ao especificar a Identity, você deve incluir o prefixo "sip:" ; por exemplo: -Identity " sip:RedmondDialIn@litwareinc.com". |
Instance |
Opcional |
Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais. |
|
DisplayName |
Opcional |
Cadeia de caracteres |
O nome para exibição do Active Directory do novo objeto de contato. Esse será o nome exibido no Microsoft Lync 2010. |
DisplayNumber |
Obrigatório |
Cadeia de caracteres |
Número de telefone, conforme exibido nos convites das reuniões e na página da Web de Configurações de Conferência Discada. DisplayNumber pode ser formatado conforme a sua preferência; por exemplo, 1-800-555-1234, 1-(800)-555-1234 ou 1.800.555.1234. |
LineUri |
Opcional |
Cadeia de caracteres |
O número de telefone da conferência discada real. LineUri deve ser especificado usando-se a seguinte sintaxe: o prefixo tel: seguido de um sinal de adição (+), do código telefônico do país/região, do código da área e do número de telefone. Por exemplo: tel:+18005551234. Espaços, hífens, parênteses e outros caracteres não são permitidos. |
PassThru |
Opcional |
Parâmetro de opção |
Permite passar um objeto de contato através do pipeline que representa o número de acesso modificado à conferência discada. Por padrão, o cmdlet Set-CsDialInConferencingAccessNumber não canaliza objetos. |
PrimaryLanguage |
Opcional |
Cadeia de caracteres |
Idioma principal usado para fazer comunicados de conferência discada. O idioma deve ser configurado usando um dos códigos de idioma da conferência discada disponíveis; por exemplo, en-US para inglês dos EUA ou fr-FR para francês. 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. |
Priority |
Opcional |
Inteiro |
Permite alterar a ordem na qual os números de conferência discada são apresentados a usuários em convites de reuniões ou quando acessam a página da Web Configurações de Conferência Discada. Números menores têm prioridade maior; para que um número apareça no início da lista, defina a prioridade como 0. Observe que, se alterar a prioridade de um número fornecido, você também deverá usar o parâmetro ReorderedRegion para indicar a região na qual a prioridade modificada deve entrar em vigor. |
Regions |
Opcional |
Cadeia de caracteres |
Regiões do plano de discagem associadas ao número discado. 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 da conferência discada. Para especificar várias regiões, use uma lista separada por vírgulas: -Regions "Northwest", "Southwest" |
ReorderedRegion |
Opcional |
Cadeia de caracteres |
Usado com o parâmetro Priority durante a alteração da prioridade de um número de conferência discada com uma região. O parâmetro ReorderedRegion indica a região na qual a reorganização de prioridades acontece; por exemplo: -ReorderedRegion "Redmond". |
ScopeToGlobal |
Opcional |
Parâmetros de opção |
Se presente, o número de conferência discada será atribuído ao escopo global. |
ScopeToSite |
Opcional |
Parâmetros de opção |
Se presente, o número de conferência discada terá o escopo no site em que o pool de Registrador do objeto de contato reside. |
SecondaryLanguages |
Opcional |
Coleção de cadeia de caracteres |
Coleção opcional de idiomas que também podem ser usados para fazer comunicados de conferência discada. 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 do Canadá e francês como idioma secundário; -SecondaryLanguages "fr-CA", "fr-FR". Um número de acesso pode ser associado a até quatro idiomas secundários. |
WhatIf |
Opcional |
Parâmetros de opção |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Parâmetros de opção |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Objeto Microsoft.Rtc.Management.Xds.AccessNumber. Set-CsDialInConferencingAccessNumber aceita entrada em pipeline do objeto de número de acesso.
Tipos de Retorno
Set-CsDialInConferencingAccessNumber não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.Xds.AccessNumber.
Exemplo
-------------------------- Exemplo 1 ------------------------
Set-CsDialInConferencingAccessNumber -Identity "sip:RedmondDialIn@litwareinc.com" -DisplayName "Redmond Dial-In Access Number"
O comando mostrado no Exemplo 1 modifica a propriedade DisplayName do número de acesso da conferência discada com Identity sip:RedmondDialIn@litwareinc.com. Nesse exemplo, o nome para exibição é definido como "Redmond Dial-In Access Number".
-------------------------- Exemplo 2 ------------------------
Set-CsDialInConferencingAccessNumber -Identity "sip:RedmondDialIn@litwareinc.com" -Regions "Redmond", "Seattle"
No Exemplo 2, o número de acesso da conferência discada com Identity sip:RedmondDialIn@litwareinc.com é modificado para incluir duas regiões: Redmond e Seattle. Para isso, o parâmetro Regions é chamado, seguido das duas regiões (dois valores da cadeia de caracteres separados por vírgulas). Observe que haverá falha nesse comando, a menos que as regiões Redmond e Seattle já tenham sido definidas em planos de discagem.
-------------------------- Exemplo 3 ------------------------
Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -eq "fr-FR"}| Set-CsDialInConferencingAccessNumber -SecondaryLanguages "fr-CA"
No exemplo anterior, todos os números de acesso da conferência discada nos quais o idioma principal seja francês são modificados para usar o francês do Canadá como idioma secundário. Para realizar essa tarefa, Get-CsDialInConferencingAccessNumber é chamado inicialmente para retornar uma coleção de todos os números de acesso discado configurados para uso na organização. Em seguida, essa coleção é redirecionada para o cmdlet Where-Object, que separa os números de acesso nos quais a propriedade PrimaryLanguage seja igual a French ("fr-FR"). Em seguida, essa coleção filtrada é redirecionada para Set-CsDialInConferencingAccessNumber, que define o valor da propriedade SecondaryLanguages como French Canadian ("fr-CA").
-------------------------- Exemplo 4 ------------------------
Get-CsDialInConferencingAccessNumber -Filter {DisplayName -eq "Default DialIn Access Number"} | Set-CsDialInConferencingAccessNumber -DisplayName "Litwareinc Conferencing"
O comando mostrado no Exemplo 4 altera o nome para exibição do Active Directory do número de acesso da conferência discada especificado. Para isso, o comando usa inicialmente Get-CsDialInConferencingAccessNumber e o parâmetro Filter para retornar o número de acesso discado em que a propriedade DisplayName seja igual a "Default DialIn Access Number". Em seguida, esse número de acesso é redirecionado para o cmdlet Set-CsDialInConferencingAccessNumber, que altera o nome para exibição para Litwareinc Conferencing.
-------------------------- Exemplo 5 ------------------------
Get-CsDialInConferencingAccessNumber -Filter {LineUri -eq "TEL:+14255558715"} | Set-CsDialInConferencingAccessNumber -DisplayNumber "1-425-555-1298" -LineUri "tel:+14255551298"
No Exemplo 5, o número para exibição e o URI da linha são modificados para o número de acesso de conferência discada especificado. Para recuperar o número a ser modificado, o comando usa inicialmente Get-CsDialInConferencingAccessNumber e o parâmetro Filter; o valor de filtro complementar limita os dados retornados ao número de acesso em que a propriedade LineUri seja igual a TEL:+14255558715. Em seguida, esse número de acesso é redirecionado para Set-CsDialInConferencingAccessNumber, que modifica as propriedades DisplayNumber e LineUri do número de acesso.
-------------------------- Exemplo 6 ------------------------
Get-CsDialInConferencingAccessNumber | Where-Object {$_.PrimaryLanguage -ne "en-US"} | Set-CsDialInConferencingAccessNumber -SecondaryLanguages "fr-FR","it-IT"
O comando anterior atribui um par de idiomas secundários a todos os números de acesso da conferência discada que não usam o inglês dos EUA como o idioma principal. Para fazer isso, o comando chama inicialmente Get-CsDialInConferencingAccessNumber para retornar uma coleção de todos os números de acesso da conferência discada configurados para uso na organização. Em seguida, essa coleção é redirecionada para o cmdlet Where-Object, que seleciona apenas os números nos quais a propriedade PrimaryLanguage não seja igual a U.S English (en-US). Em seguida, a coleção filtrada é redirecionada para Set-CsDialInConferencingAccessNumber, que usa o parâmetro -SecondaryLanguages para atribuir cada número na coleção aos idiomas secundários francês (fr-FR) e italiano (it-IT).
-------------------------- Exemplo 7 ------------------------
Get-CsDialInConferencingAccessNumber -Identity ""sip:RedmondDialIn@litwareinc.com"" -Priority 0 -ReorderedRegion Redmond
O comando mostrado no Exemplo 7 atribui ao número de acesso de conferência discada "sip:RedmondDialIn@litwareinc.com" a mais alta prioridade na região de Redmond; com isso, o número é listado em primeiro lugar nos convites de reuniões e na página da Web de conferência discada. Para definir a prioridade, o parâmetro Priority é incluído com o valor de parâmetro 0 (o número de acesso de prioridade mais alto tem valor de Priority igual a 0, o segundo tem valor de Priority igual a 1 e assim por diante). Além disso, o parâmetro ReorderedRegion é incluído para indicar que as prioridades de número de acesso devem ser alteradas dentro da região de Redmond.
Consulte Também
Outros Recursos
Get-CsDialInConferencingAccessNumber
New-CsDialInConferencingAccessNumber
Remove-CsDialInConferencingAccessNumber