Remove-CsUserAcp
Tópico modificado em: 2012-03-25
Remove um ou vários provedores de audioconferências atribuídos a um usuário ou grupo de usuários.
Sintaxe
Remove-CsUserAcp -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-Name <String>] [-ParticipantPasscode <String>] [-PassThru <SwitchParameter>] [-TollNumber <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 oferecem 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 possam 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.
Qualquer provedor de audioconferências atribuído a um usuário poderá ser removido posteriormente, utilizando o cmdlet Remove-CsUserAcp. O ato de chamar Remove-CsUserAcp sem qualquer parâmetro (diferente de Identity, que indica a conta do usuário a ser modificada) removerá todos os provedores de audioconferências atribuídos a um usuário. Como alternativa, é possível usar os parâmetros opcionais incluídos com Remove-CsUserAcp, para remover os provedores selecionados de uma conta de usuário. Por exemplo: esse comando localiza a conta do usuário Ken Myer e remove todos os provedores de audioconferências cujo Nome for igual a “Fabrikam ACP”:
Remove-CsUserAcp –Identity "Ken Myer" –Name "Fabrikam ACP"
Para obter uma remoção mais minuciosa dos provedores de audioconferências, basta incluir parâmetros adicionais. Por exemplo: o comando a seguir remove qualquer provedor de audioconferências que possuir o Nome “Fabrikam ACP” e que possuir TollNumber igual a "14255551298", como a seguir:
Remove-CsUserAcp –Identity "Ken Myer" –Name "Fabrikam ACP" –TollNumber "14255551298"
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-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 "Remove-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 da qual o provedor de audioconferências deverá ser removido. É 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 o nome diferenciado do usuário no Active Directory. É possível utilizar usar o caractere curinga asterisco (*) ao usar 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". |
Name |
Opcional |
Cadeia de caracteres |
Nome do provedor de audioconferências. Por exemplo: -Name "Fabrikam Conference Services". |
ParticipantPassCode |
Opcional |
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 |
Opcional |
Cadeia de caracteres |
Número de telefone gratuito usado nas audioconferências. Por exemplo: -TollNumber "14255551298". |
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 Remove-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. Remove-CsUserAcp aceita um valor canalizado de cadeia de caracteres, que representa a Identidade de uma conta de usuário que foi habilitada para Microsoft 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 ------------------------
Remove-CsUserAcp -Identity "Ken Myer"
O comando exibido no Exemplo 1 remove todos os provedores de audioconferências que tiverem sido atribuídos ao usuário Ken Myer.
-------------------------- Exemplo 2 ------------------------
Get-CsUser | Remove-CsUserAcp
O Exemplo 2 mostra como é possível remover todos os provedores de audioconferências que tiverem sido atribuídos a todos os usuários habilitados pelo Lync Server 2010. Para fazer isso, o comando primeiramente utiliza Get-CsUser, para recuperar uma coleção de todos os usuários que tiverem sido habilitados para o Lync Server. Essa coleção será então canalizada para o cmdlet Remove-CsUserAcp, que removerá todos os provedores de audioconferências que tiverem sido atribuídos a cada usuário na coleção.
-------------------------- Exemplo 3 ------------------------
Remove-CsUserAcp -Identity "Ken Myer" -Name "Fabrikam ACP"
No Exemplo 3, todos os provedores de audioconferências que possuírem o Nome "Fabrikam ACP" serão removidos da conta do usuário Ken Myer.
-------------------------- Exemplo 4 ------------------------
Get-CsUserAcp | Where-Object {$_.AcpInfo -match "14255551298"} | Remove-CsUserAcp
O comando anterior remove o provedor de audioconferências que possuir o número de chamada tarifada "14255551298" de todas as contas de usuário que tiverem recebido a atribuição de um provedor de audioconferências. Para realizar essa tarefa, o comando primeiramente utiliza Get-CsUserAcp, para retornar informações sobre todos os provedores de audioconferências atribuídos a todos os usuários. Essas informações serão então canalizadas para o cmdlet Where-Object, que selecionará apenas as contas cuja propriedade AcpInfo incluir (-match) o número de telefone "14255551298". Essa coleção filtrada será então canalizada para o cmdlet Remove-CsUserAcp, que removerá o respectivo provedor de audioconferências de cada conta na coleção filtrada.