Set-CsUserAcp
Tópico modificado em: 2012-03-27
Adiciona um novo provedor de audioconferências a um usuário ou grupo de usuários, ou modifica um provedor de audioconferências já atribuído a um usuário.
Sintaxe
Set-CsUserAcp -Identity <UserIdParameter> -Domain <String> -Name <String> -ParticipantPasscode <String> -TollNumber <String> [-Confirm [<SwitchParameter>]] [-IsDefault <$true | $false>] [-PassThru <SwitchParameter>] [-TollFreeNumbers <String[]>] [-Url <String>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Um provedor de audioconferências é uma empresa de terceiros que oferece serviços de conferências às organizações. Entre outras coisas, os provedores de audioconferências oferecem uma maneira para que usuários de fora do site, e não conectados à rede corporativa ou à Internet, participem da parte de áudio de uma conferência ou reunião. Os provedores de audioconferências incluem serviços de alta tecnologia, como traduções ao vivo, transcrições e assistência de operador por conferência.
O Microsoft Lync Server 2010 não permite a integração completa com provedores de audioconferências. Os cmdlets CsUserAcp permitem que os administradores definam um número de telefone e uma senha, e configurem outras informações que podem ser usadas para a integração com o provedor de audioconferências, sempre que um usuário agendar uma reunião. No entanto, como esses cmdlets não foram projetados para a versão local do Lync Server (em vez disso, o seu uso foi projetado para funcionar conjuntamente ao Microsoft Lync Online 2010), não será fornecida qualquer integração adicional com o provedor de audioconferências, além da atribuição de valores de propriedade.
Os provedores de audioconferências podem ser atribuídos a uma conta de usuário, utilizando-se o cmdlet Set-CsUserAcp. (observe que um usuário poderá receber a atribuição de diversos provedores de audioconferências). Set-CsUserAcp também é utilizado para modificar as propriedades de um provedor de audioconferências existente. Se Set-CsUserAcp for chamado, o cmdlet utilizará as informações de parâmetro incluídas na chamada para verificar os provedores de audioconferências existentes atribuídos ao usuário. Se for encontrada uma correspondência, o provedor existente será modificado. Por exemplo, suponha que se emita o comando a seguir:
Set-CsUserAcp –Identity "Ken Myer" –TollNumber "15554251298" –ParticipantPassCode 13761 –Domain "fabrikam.com" –Name "Fabrikam ACP"
A seguir, suponhamos que Ken Myer já tenha recebido a atribuição de um provedor de audioconferências denominado Fabrikam ACP, que possui o mesmo TollNumber e Domain que os especificados no comando. (em outras palavras, a única diferença é ParticipantPassCode). Nesse caso, Set-CsUserAcp modificará o provedor Fabrikam ACP existente. Se não for encontrada correspondência, será adicionado um novo provedor à conta do usuário Ken Myer.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsUserAcp localmente: RTCUniversalUserAdmins. 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 (inclusive qualquer função RBAC personalizada criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsUserAcp"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
Identidade do usuário |
Indica a Identidade da conta de usuário a ser modificada. É possível especificar a identidade de um usuário usando-se um dos quatro formatos: 1) O endereço SIP do usuário, 2) o UPN (nome principal de usuário), 3) o nome de domínio e nome de logon do usuário, na forma domínio\logon (por exemplo: litwareinc\kenmyer) e 4) o Serviços de Domínio Active Directory (AD DS)nome de exibição do usuário no Active Directory (por exemplo: Ken Myer). Também é possível fazer referência às identidades de usuário, usando-se o nome diferenciado do usuário no Active Directory. É possível utilizar o caractere curinga asterisco (*) ao se utilizar o Nome de Exibição como Identidade de usuário. Por exemplo, a Identidade "* Smith" retornará todos os usuários com um nome de exibição que termine com o valor de cadeia de caracteres "Smith". |
Domain |
Obrigatório |
Cadeia de caracteres |
Nome do domínio do provedor de audioconferências. Por exemplo: -Domain "fabrikam.com". |
Name |
Obrigatório |
Cadeia de caracteres |
Nome do provedor de audioconferências. Por exemplo: -Name "Fabrikam Conference Services". |
ParticipantPasscode |
Obrigatório |
Cadeia de caracteres |
Senha necessária para se conectar a uma conferência por meio do provedor de audioconferências. Por exemplo: -PassCode "0712". |
TollNumber |
Obrigatório |
Cadeia de caracteres |
Número de telefone gratuito usado nas audioconferências. Por exemplo: -TollNumber "14255551298". |
IsDefault |
Opcional |
Booleano |
Indica se esse é o provedor de audioconferências padrão do usuário ou não. Cada usuário pode ter apenas um provedor padrão. |
TollFreeNumbers |
Opcional |
Cadeia de caracteres |
Coleção de números de telefone gratuitos usados nas audioconferências. Por exemplo: -TollFreeNumbers "18005551298". Para adicionar números gratuitos, separe cada número por vírgulas: -TollFreeNumber "18005551298", "18005559876". |
Url |
Opcional |
Cadeia de caracteres |
URL do provedor de audioconferências na Web. Por exemplo: -Url "http://acp.fabrikam.com". O URL da Web permite que provedores de audioconferências levem os usuários a uma página da web que contém números de telefone adicionais para discagem, bem como informações sobre os serviços oferecidos pelo provedor de audioconferências. |
PassThru |
Opcional |
Parâmetro de opção |
Permite canalizar um objeto de usuário que represente o usuário cujo provedor de audioconferências está sendo removido. Por padrão, o cmdlet Set-CsUserAcp não canaliza objetos. |
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
Cadeia de caracteres ou objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Set-CsUserAcp aceita um valor canalizado de cadeia de caracteres, que representa a Identidade de uma conta de usuário que foi habilitada para Lync Server 2010. Esse cmdlet também aceita instâncias canalizadas do objeto de usuário no Active Directory.
Tipos de Retorno
Nenhuma.
Exemplo
-------------------------- Exemplo 1 ------------------------
Set-CsUserAcp -Identity "Ken Myer" -TollNumber "14255551298" -ParticipantPassCode 13761 -Domain "fabrikam.com" -Name "Fabrikam ACP"
No Exemplo 1, Set-CsUserAcp é utilizado para atribuir um novo provedor de audioconferências ao usuário Ken Myer. Para fazer isso, utiliza-se o parâmetro Identity para indicar a conta do usuário a ser modificada. Além disso, incluem-se os parâmetros obrigatórios (TollNumber, ParticipantPassCode, Domain e Name), juntamente com os valores de parâmetro relevantes.
-------------------------- Exemplo 2 ------------------------
Get-CsUser -LdapFilter "Department=Finance" | Set-CsUserAcp -TollNumber "14255551298" -ParticipantPassCode 13761 -Domain "fabrikam.com" -Name "Fabrikam ACP"
O comando apresentado no Exemplo 2 atribui o mesmo provedor de audioconferências a todos os usuários que trabalharem no departamento Financeiro. Para isso, o comando primeiramente usa Get-CsUser e LdapFilter (com o valor de filtro "Department=Finance"), para retornar uma coleção de todos os usuários que trabalharem no departamento Financeiro. Essa coleção será então canalizada para o cmdlet Set-CsUserAcp, que atribuirá o mesmo provedor de audioconferências (Fabrikam ACP) a cada usuário na coleção.
-------------------------- Exemplo 3 ------------------------
Set-CsUserAcp -Identity "Ken Myer" -TollNumber "14255551298" -ParticipantPassCode 13761 -Domain "fabrikam.com" -Name "Fabrikam ACP" -TollFreeNumbers "18005551010", "18005551020"
O comando anterior atribui o provedor de audioconferências Fabrikam ACP ao usuário Ken Myer. Além de especificar TollNumber, ParticipantPassCode, Domain e Name, esse comando também inclui um par de números de telefone gratuitos. Para atribuir esses dois valores, inclui-se o parâmetro TollFreeNumbers, seguido dos dois números de telefone, separados um do outro por uma vírgula.