Set-CsUser
Tópico modificado em: 2012-03-26
Modifica as propriedades do Microsoft Lync Server 2010 para uma conta de usuário existente. As propriedades podem ser modificadas só para contas que foram permitidas para uso com o Lync Server 2010.
Sintaxe
Set-CsUser -Identity <UserIdParameter> [-AcpInfo <MultiValuedProperty>] [-AudioVideoDisabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-HostedVoiceMail <Nullable>] [-LineServerURI <String>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrivateLine <String>] [-RemoteCallControlTelephonyEnabled <$true | $false>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Set-CsUser permite que você modifique os atributos de conta de usuário relacionados ao Lync Server que estão armazenados no Serviços de Domínio Active Directory (AD DS). Por exemplo, você pode desabilitar ou reabilitar um usuário para Lync Server; habilitar ou desabilitar um usuário para comunicações de A/V (áudio/vídeo); ou modificar a linha privada do usuário e os números do URI da linha. O Set-CsUser pode ser usado somente para usuários que foram habilitados para Lync Server.
Os únicos atributos que podem ser modificados usando Set-CsUser são atributos relacionados ao Lync Server. Outros atributos de conta de usuário, tais como o cargo ou departamento, não podem ser modificados usando-se este cmdlet.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsUser localmente: RTCUniversalUserAdmins. 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-CsUser\b"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
XdsIdentity |
Indica a Identity da conta do usuário a ser modificada. Identidades de usuários podem ser especificadas usando-se um dos quatro formatos: 1) O endereço SIP do usuário; 2) o nome UPN do usuário; 3) o nome de domínio do usuário e nome de logon, na forma domínio\logon (por exemplo, litwareinc\kenmyer); e, 4) o nome de exibição do Active Directory do usuário (por exemplo, Ken Myer). As Identidades de Usuário também podem ser referenciadas usando-se o nome diferenciado de usuário do Active Directory. Você pode usar o caractere curinga asterisco (*) ao usar o nome para exibição como Identidade do usuário. Por exemplo, Identity "* Smith" retorna todos os usuários com nome para exibição terminando com o valor de cadeia de caracteres " Smith". |
ACPInfo |
Opcional |
Matriz de objetos ACPInfo |
Permite a atribuição de um ou mais provedores de serviços de audioconferência de terceiros a um usuário. No entanto, recomendamos o uso do cmdlet Set-UserAcp para a atribuição de provedores de audioconferência. |
AudioVideoDisabled |
Opcional |
Booleano |
Indica se o usuário tem permissão para fazer chamadas de A/V (áudio e vídeo) usando o Lync 2010. Se definido como True, o envio e o recebimento de mensagens instantâneas pelo usuário será amplamente restrito. Você não pode desativar comunicações A/V se um usuário estiver habilitado no momento para controle de chamada remota, Enterprise Voice e/ou roteamento de telefone IP-PBX. |
Enabled |
Opcional |
Booleano |
Indica se o usuário foi habilitado ou não para Lync Server. Se este valor for definido como False, o usuário não vai mais ser capaz de fazer logon no Lync Server; definir este valor como True reabilita os privilégios de logon do usuário. Se você desativar uma conta usando o parâmetro Enabled, as informações associada a esta conta (incluindo diretivas atribuídas e se o usuário está ou não habilitado para o Enterprise Voice e/ou o controle de chamada remota) são retidas. Se a conta for reabilitada posteriormente com o parâmetro Enabled, as informações de conta associadas serão restauradas. Isso é diferente de se usar o cmdlet Disable-CsUser para desativar uma conta de usuário. Quando você executa Disable-CsUser, todos os dados do Lync Server associados com esta conta são excluídos. |
DomainController |
Opcional |
Cadeia de caracteres |
Permite que você especifique um controlador de domínio ao qual se conectar quando estiver modificando uma conta de usuário. Se o parâmetro não for incluído, então o cmdlet vai usar o primeiro controlador de domínio disponível. |
EnterpriseVoiceEnabled |
Opcional |
Booleano |
Indica se o usuário foi habilitado para o Enterprise Voice, a implementação de protocolo VoIP da Microsoft. Com o Enterprise Voice, os usuários podem fazer chamadas telefônicas usando a Internet, em vez da rede telefônica padrão. |
HostedVoiceMail |
Opcional |
Booleano |
Quando definido como True, permite que as chamadas de caixa postal do usuário sejam roteadas para uma versão hospedada do Microsoft Exchange Server. Além disso, definir esta opção como True permite que os usuários do Lync 2010 façam uma ligação direta à caixa postal de outro usuário. |
LineURI |
Opcional |
Cadeia de caracteres |
Número de telefone atribuído ao usuário. A linha URI deve ser especificada usando o formato E.164 e usar "TEL:" como prefixo. Por exemplo: TEL:+14255551297. Qualquer número de ramal deve ser adicionado ao final do URI de linha, como por exemplo: TEL:+14255551297; ext=51297. É importante observar que o Lync Server trata o TEL:+14255551297 e o TEL:+14255551297;ext=51297 como dois números diferentes. Se você atribuir Ken Myer ao URI da linha TEL:+14255551297 e tentar atribuir posteriormente Pilar Ackerman ao URI da linha TEL:+14255551297;ext=51297, essa atribuição será bem-sucedida; o número atribuído à Pilar não será sinalizado como um número duplicado. Isso ocorre porque, dependendo da sua configuração, esses dois números poderiam realmente ser diferentes. Por exemplo, em algumas organizações, discar 1-425-555-1297 roteia sua chamada para um Atendente Automático do Exchange. Por outro lado, discar somente a extensão (51297) ou usar o Microsoft Lync 2010 para discar o número 1-425-555-1297 e extensão 51297 roteará sua chamada diretamente para o usuário. |
LineServerURI |
Opcional |
Cadeia de caracteres |
O URI do gateway telefônico de controle de chamada remota designado ao usuário. O LineServerUri é o URI de gateway, prefaciado por "sip:". Por exemplo: sip:rccgateway@litwareinc.com |
PrivateLine |
Opcional |
Cadeia de caracteres |
Número de telefone para a linha de telefone privada do usuário. Uma linha privada é um número de telefone que não é publicado no Serviços de Domínio Active Directory (AD DS) e, dessa forma, não está prontamente disponível a outras pessoas. Além disso, essa linha privada ignora a maioria das regras de roteamento da chamada de entrada; por exemplo, uma chamada a uma linha privada não vai ser encaminhada aos representantes de uma pessoa. As linhas privadas são frequentemente usadas para chamadas telefônicas pessoais, que devem ser mantidas separadas de outros membros da equipe. O valor da linha privada deve ser especificado usando o formato E.164, e ter "TEL:" como prefixo. Por exemplo: TEL:+14255551297. |
RemoteCallControlTelephonyEnabled |
Opcional |
Booleano |
Indica se o usuário foi habilitado para telefonia de controle de chamada remota. Quando habilitado para controle de chamada remota, o usuário pode empregar o Lync Server para responder chamadas telefônicas feitas ao seu telefone. Também é possível fazer chamadas telefônicas usando o Lync 2010. Todas estas chamadas contam com a rede de telefone padrão, também conhecida como rede telefônica pública comutada (PSTN). Para fazer e receber chamadas telefônicas através da Internet, o usuário precisa estar habilitado para Enterprise Voice. Para detalhes, consulte o parâmetro EnterpriseVoiceEnabled. Para estar habilitado para controle de chamada remoto, um usuário precisa ter um LineUri e um LineServerUri. |
SipAddress |
Opcional |
Cadeia de caracteres |
Identificador único (semelhante ao endereço de email) que permite ao usuário se comunicar usando dispositivos SIP, tal como o Lync 2010. O endereço SIP deve usar o prefixo sip: e um domínio SIP válido; por exemplo: -SipAddress sip:kenmyer@litwareinc.com. |
PassThru |
Opcional |
Parâmetro de Opção |
Permite que você passe um objeto de usuário através do pipeline que representa o usuário cuja conta está sendo modificada. Por padrão, o cmdlet Set-CsUser não passa objetos através do pipeline. |
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-CsUser aceita um valor de cadeia de caracteres em pipeline representando o parâmetro Identity de uma conta de usuário que tenha sido habilitada para o Lync Server. O cmdlet também aceita instâncias em pipeline do objeto de usuário do Active Directory.
Tipos de Retorno
Set-CsUser não retorna nenhum objeto.
Exemplo
-------------------------- Exemplo 1 --------------------------
Set-CsUser -Identity "Pilar Ackerman" -EnterpriseVoiceEnabled $True
No Exemplo 1, o Set-CsUser é usado para modificar a conta do usuário com Identity Pilar Ackerman. Nesse caso, a conta é modificada para habilitar o Enterprise Voice, a implementação de VoIP da Microsoft. Esta tarefa é executada adicionando-se o parâmetro EnterpriseVoiceEnabled, e em seguida definindo o valor do parâmetro para $True.
-------------------------- Exemplo 2 --------------------------
Get-CsUser -LdapFilter "Department=Finance" | Set-CsUser -EnterpriseVoiceEnabled $True
No Exemplo 2, todos os usuários no departamento de Finanças têm suas contas habilitadas para Enterprise Voice. Nesse comando, o cmdlet Get-CsUser e o LDAPFilter são usados primeiro para retornar a coleção de todos os usuários que trabalham no departamento de Finanças. Essa informação é então passada para Set-CsUser, que habilita Enterprise Voice para cada conta na coleção.