Compartilhar via

  • Artigo

Set-CsCommonAreaPhone

 

Tópico modificado em: 2012-03-27

Modifica os valores de propriedade de um telefone de área comum gerenciado pelo Microsoft Lync Server 2010. Telefones de área comum são telefones localizados em lobbies de edifícios, lounges para funcionários e demais áreas nas quais possam ser utilizados por várias pessoas diferentes e para vários fins diferentes.

Sintaxe

Set-CsCommonAreaPhone -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayName <String>] [-DisplayNumber <String>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Telefones de área comum são telefones IP que não estão associados a um usuário individual. Em vez de estarem localizados no escritório de alguém, esses telefones geralmente estão localizados em lobbies de edifícios, cafeterias, lounges para funcionários, salas de reuniões e outros locais que possam receber um grande número de pessoas. Isso é um desafio de gerenciamento para os administradores: o uso de um telefone no Lync Server 2010 geralmente é mantido usando-se várias diretivas de voz e planos de discagem, atribuídos a usuários individuais. Os telefones de área comum não são atribuídos a usuários individuais.

Uma solução é criar objetos de contato do Active Directory para todos os seus telefones de área comum (esses objetos de contato podem ser criados com o cmdlet New-CsCommonAreaPhone). Assim como as contas de usuário, esses objetos de contato podem ser atribuídos a diretivas e planos de voz. Com isso, é possível manter o controle sobre os telefones de área comum mesmo que esses telefones não estejam associados a um usuário individual. Por exemplo, se você não quiser que as pessoas possam transferir ou estacionar chamadas em um telefone de área comum, crie uma diretiva de voz que proíba a transferência e o estacionamento de chamadas, e atribua essa diretiva ao telefone de área comum. (Ou, o que seria mais correto, atribuir essa diretiva ao objeto de contato que representa o telefone de área comum). Este comando atribui a diretiva de voz CommonAreaPhoneVoicePolicy a todos os seus telefones de área comum:

Get-CsCommonAreaPhone | Grant-CsVoicePolicy –PolicyName "CommonAreaPhoneVoicePolicy"

O cmdlet Set-CsCommonAreaPhone oferece uma maneira de modificar as propriedades de objetos de contato associados a telefones de área comum. Dentre outras coisas, é possível alterar o nome para exibição do Active Directory do contato ou a linha URI associada ao telefone. O parâmetro Enabled também pode ser usado para habilitar e desabilitar a conta para uso com o Lync Server 2010.

Além disso, você pode configurar o "compartilhamento" de telefones de área comum usando os cmdlets CsClientPolicy. Quando um telefone é compartilhado, os usuários podem fazer logon no telefone usando suas credenciais do Lync Server. Entre outras coisas, isso permite que os usuários acessem facilmente seus contatos. Para obter mais informações, consulte o tópico da Ajuda referente ao cmdlet Set-CsClientPolicy.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsCommonAreaPhone localmente: RTCUniversalUserAdmins. Permissões para executar este cmdlet para sites específicos ou OUs (unidades organizacionais) do Active Directory específicas podem ser atribuídas com o cmdlet Grant-CsOUPermission. 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-CsCommonAreaPhone"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Parâmetro User ID

Identificador exclusivo do telefone de área comum. Os telefones de área comum são identificados usando-se o nome diferenciado do Active Directory do objeto de contato associado. Por padrão, telefones de área comum usam um GUID (identificador global exclusivo) como nome comum; ou seja, os telefones geralmente terão uma Identidade semelhante a esta: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com. Com isso, pode ser mais fácil obter telefones de área comum usando o cmdlet Get-CsCommonAreaPhone e canalizando os objetos retornados para Set-CsCommonAreaPhone.

Enabled

Opcional

Cadeia de caracteres

Indica se o objeto de contato do telefone de área comum foi habilitado ou não para o Lync Server 2010.

Se você desativar um contato usando o parâmetro Enabled, as informações associadas a essa conta (incluindo diretivas atribuídas e se o contato está ou não habilitado para o Enterprise Voice, controle de chamada remota e/ou integração de caixa postal) são retidas. Se a conta for reabilitada posteriormente com o parâmetro Enabled, as informações de conta associadas serão restauradas.

Description

Opcional

Cadeia de caracteres

Permite modificar o atributo de descrição do Active Directory para o telefone de área comum. Isso oferece uma maneira de se fornecer informações adicionais sobre o telefone; por exemplo, detalhes sobre quem contatar em caso de problemas com o telefone.

DisplayName

Opcional

Cadeia de caracteres

Permite a modificação do nome para exibição no Active Directory do telefone de área comum.

DisplayNumber

Opcional

Cadeia de caracteres

Número de telefone exibido no Microsoft Lync 2010. A propriedade DisplayNumber pode ser formatada conforme a sua preferência; por exemplo, 1-800-555-1234; 1-(800)-555-1234; 1.800.555.1234; etc. Ao escolher um número para exibição, tenha em mente que esse número será exibido na tela do telefone de área comum apenas se o número puder ser normalizado (normalização é o processo de tradução de cadeias numéricas em um formato padrão de número de telefone). Se não existir uma regra de normalização para o formato de número de telefone usado na configuração do número para exibição, a tela do telefone de área comum exibirá o valor da propriedade LineUri, e não o valor da propriedade DisplayNumber.

DomainController

Opcional

Cadeia de caracteres

Permite sua conexão ao controlador de domínio especificado para modificar as informações de contato. Para conectar a um determinado controlador de domínio, inclua o parâmetro DomainController seguido pelo nome de computador (por exemplo, atl-mcs-001) ou o seu FQDN (nome de domínio totalmente qualificado); por exemplo: atl-mcs-001.litwareinc.com.

EnterpriseVoiceEnabled

Opcional

Booleano

Indica se o objeto de contato do telefone de área comum foi habilitado ou não para o Enterprise Voice, a solução de protocolo VoIP oferecida pela Microsoft. Com o Enterprise Voice, chamadas telefônicas podem ser feitas usando a Internet em vez da rede telefônica padrão.

LineUri

Opcional

Cadeia de caracteres

Número de telefone do telefone de área comum. A linha URI deve ser especificada usando o formato E.164 e receber o prefixo "TEL:" . Por exemplo: TEL:+14255551297. Qualquer número de ramal deve ser adicionado ao fim da linha URI; por exemplo: TEL:+14255551297; ext=51297.

SipAddress

Opcional

Endereço SIP

Identificador exclusivo que permite que o telefone de área comum se comunique com dispositivos SIP como o Lync 2010. O endereço SIP deve levar o prefixo sip: e incluir um domínio SIP válido. Por exemplo: sip:bldg14lobby@litwareinc.com.

PassThru

Opcional

Parâmetros de Opção

Retorna um objeto representando o telefone de área comum.

WhatIf

Opcional

Parâmetros de Opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetros de Opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact.

Tipos de Retorno

Por padrão, Set-CsCommonAreaPhone não retorna nenhum objeto ou valor. No entanto, se o parâmetro PassThru for incluído, o cmdlet irá retornar instâncias do objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact.

Exemplo

-------------------------- Exemplo 1 ------------------------

Get-CsCommonAreaPhone -Filter {LineUri -eq "tel:+14255556710"} | Set-CsCommonAreaPhone -DisplayName "Employee Lounge"

O Exemplo 1 modifica o nome para exibição no Active Directory para o telefone de área comum com o número de telefone 1-425-555-6710. Para isso, Get-CsCommonAreaPhone é chamado inicialmente com o parâmetro Filter; o valor de filtro {LineUri -eq "tel:+14255556710"} limita os dados retornados ao telefone de área comum no qual a propriedade LineUri seja igual a +14255556710. Em seguida, o objeto retornado é canalizado para Set-CsCommonAreaPhone, que define o valor da propriedade DisplayName como "Employee Lounge".

-------------------------- Exemplo 2 ------------------------

Get-CsCommonAreaPhone | Set-CsCommonAreaPhone -Enabled $True

O comando mostrado no Exemplo 2 habilita todos os telefones de área comum configurados atualmente para uso na organização. Para executar esta tarefa, o comando chama Get-CsCommonAreaPhone, sem nenhum parâmetro, para retornar uma coleção de todos os telefones de área comum. Em seguida, essa coleção é redirecionada para o cmdlet Set-CsCommonAreaPhone, que seleciona cada item da coleção e define a propriedade Enabled como True.

-------------------------- Exemplo 3 ------------------------

Get-CsCommonAreaPhone -Filter {Description -eq $Null} | Set-CsCommonAreaPhone -Description "Common area phone"

O comando anterior adiciona uma descrição genérica a todos os telefones de área comum que não tenham um valor atribuído à propriedade Description. Para isso, Get-CsCommonAreaPhone é chamado com o parâmetro Filter; o valor de filtro {Description -eq $Null} garante que os únicos itens retornados sejam telefones de área comum nos quais a propriedade Description seja igual a um valor nulo. Em seguida, essa coleção filtrada é redirecionada para Set-CsCommonAreaPhone, que atribui a descrição genérica "Common area phone" a cada item da coleção.