Get-CsUserAcp
Tópico modificado em: 2012-03-23
Retorna informações sobre os provedores de audioconferências (ACPs) atribuídos a um usuário ou grupo de usuários.
Sintaxe
Get-CsUserAcp [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-Filter <String>] [-LdapFilter <String>] [-ResultSize <Unlimited>]
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 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.
O cmdlet Get-CsUserAcp permite retornar informações sobre os provedores de audioconferências que tiverem sido atribuídos a um usuário ou grupo de usuários. Para retornar informações relativas ao provedor de audioconferências de um único usuário, basta incluir o parâmetro Identity, seguido da Identidade do usuário cujas informações devem ser retornadas. Para retornar informações sobre diversos usuários, é possível usar o parâmetro LdapFilter ou Filter. O parâmetro LdapFilter permite utilizar atributos genéricos do Active Directory, como Department ou Title, ao se especificar as informações de conta do usuário. Por exemplo: o valor de parâmetro "Title=Accountant" restringe as informações retornadas aos usuários que possuírem o cargo de contador. O parâmetro Filter permite utilizar atributos específicos ao Microsoft Lync Server 2010 (como VoicePolicy ou EnterpriseVoiceEnabled) para filtrar os dados retornados. Por exemplo: o valor de filtro {EnterpriseVoiceEnabled –eq $True} limita as contas de usuários retornadas pelo Get-CsUserAcp aos usuários que tiverem sido habilitados para o Enterprise Voice.
Como alternativa, é possível chamar Get-CsUserAcp sem qualquer parâmetro, para retornar informações relativas ao provedor de audioconferências de todos os usuários. Observe que Get-CsUserAcp retorna informações do provedor de audioconferências de todos os usuários, inclusive os que não tiverem sido habilitados para Lync Server.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsUserAcp localmente: RTCUniversalUserAdmins e RTCUniversalReadOnlyAdmins. 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 "Get-CsUserAcp"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Opcional |
Identidade do usuário |
Indica a Identidade da conta de usuário a ser recuperada. É possível especificar a identidade de um usuário usando 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 a uma conta 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". |
Credential |
Opcional |
Objeto PS Credential |
Permite executar o cmdlet Get-CsUserAcp com as credenciais alternativas. Isto pode ser necessário se a conta que você usou para fazer o logon no Windows não tiver os privilégios necessários para trabalhar com objetos de contato. Para usar o parâmetro Credential, é necessário criar primeiramente um objeto PSCredential, usando o cmdlet Get-Credential. Para obter mais detalhes, consulte o tópico da Ajuda referente ao cmdlet Get-Credential. |
Filter |
Opcional |
Cadeia de caracteres |
Permite limitar os dados retornados, filtrando-se atributos específicos a Lync Server. Por exemplo, é possível limitar os dados retornados aos usuários aos quais tiver sido atribuída uma política de voz específica, ou aos usuários que não tiverem recebido a atribuição de uma política de voz específica. O parâmetro Filter usa a mesma sintaxe de filtragem Windows PowerShell utilizada pelo cmdlet Where-Object. Por exemplo: um filtro que retorna apenas os usuários que tiverem sido habilitados para o Enterprise Voice poderia ter essa aparência, onde EnterpriseVoiceEnabled representa o atributo Serviços de Domínio Active Directory (AD DS), -eq, o operador de comparação (igual a) e $True (uma variável interna do Windows PowerShell), o valor de filtro: {EnterpriseVoiceEnabled -eq $True} |
LdapFilter |
Opcional |
Cadeia de caracteres |
Permite limitar os dados retornados, filtrando-se atributos genéricos do Active Directory (ou seja, atributos que não são específicos a Lync Server). Por exemplo, é possível limitar os dados retornados aos usuários que trabalharem em um departamento específico ou aos usuários que tiverem um gerente ou cargo específico. Ao criar filtros, o parâmetro LdapFilter usa a linguagem de consulta LDAP. Por exemplo, um filtro que retorna apenas os usuários que trabalharem na cidade de Redmond poderia ter a seguinte aparência: "l=Redmond", onde "l" (uma letra L minúscula) representa o atributo do Active Directory (localidade); "=", o operador de comparação (igual a); e "Redmond", o valor do filtro. |
ResultSize |
Opcional |
Inteiro |
Permite limitar o número de registros retornados por um comando. Por exemplo, para retornar sete usuários (independentemente de quantos usuários houver na floresta), inclua o parâmetro -ResultSize e defina o valor de parâmetro como 7. Observe que não há como garantir quais serão os sete usuários retornados. Se você definir o ResultSize como 7, mas só houver três usuários na sua floresta, o comando retornará os três usuários e, em seguida, concluirá sem erro. O tamanho do resultado pode ser definido por 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-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.
Tipos de Retorno
Get-CsUserAcp retorna instâncias do objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUserAcp.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsUserAcp
O comando exibido no Exemplo 1 retorna informações sobre o provedor de audioconferências de todos os usuários na organização.
-------------------------- Exemplo 2 ------------------------
Get-CsUserAcp -Identity "Ken Myer"
O comando anterior retorna informações sobre o provedor de audioconferências de um único usuário: o usuário com a identidade Ken Myer. Nesse caso, a identidade é especificada usando-se o nome de exibição do usuário no Active Directory.
-------------------------- Exemplo 3 ------------------------
Get-CsUserAcp -Filter {AcpInfo -ne $Null}
O Exemplo 3 retorna informações sobre todos os usuários que tiverem sido atribuídos a pelo menos um provedor de audioconferências. Para isso, inclui-se o parâmetro Filter, juntamente com o valor de filtro {AcpInfo –ne $Null}. Esse valor de filtro limita os dados retornados aos usuários cuja propriedade AcpInfo não for igual a um valor nulo. Para retornar informações sobre os usuários aos quais não tiver sido atribuído um provedor de audioconferências, use o seguinte valor de filtro:
{AcpInfo –eq $Null}.
-------------------------- Exemplo 4 ------------------------
Get-CsUserAcp | Where-Object {$_.AcpInfo -match "Fabrikam ACP"
O comando anterior retorna informações do provedor de audioconferências de qualquer usuário ao qual tiver sido atribuído o provedor de audioconferências Fabrikam ACP. Para realizar essa tarefa, o comando primeiramente utiliza Get-CsUserAcp, sem parâmetros, para retornar informações sobre o provedor de audioconferências de todos os usuários na organização. Essas informações serão então canalizadas para o cmdlet Where-Object, que selecionará qualquer usuário cuja propriedade AcpInfo incluir (-match) o valor de cadeia de caracteres "Fabrikam ACP".
-------------------------- Exemplo 5 ------------------------
Get-CsUserAcp -Identity "Ken Myer" | Select-Object -ExpandProperty AcpInfo
No Exemplo 5, são exibidas informações detalhadas sobre os provedores de audioconferências atribuídos ao usuário Ken Myer. Para isso, Get-CsUserAcp é primeiramente chamado, para retornar informações de provedores de audioconferências de Ken Myer. Estas informações serão canalizadas para o cmdlet Select-Object, que utilizará o parâmetro ExpandProperty para "expandir" o valor da propriedade AcpInfo. Quando se expande um valor de propriedade, todas as informações armazenadas nesse valor serão exibidas, de forma a proporcionar uma leitura fácil.