Compartilhar via

  • Artigo

New-CsCommonAreaPhone

 

Tópico modificado em: 2012-03-23

Cria um novo telefone de área comum que pode ser gerenciado usando o 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

New-CsCommonAreaPhone -LineUri <String> -OU <OUIdParameter> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayName <String>] [-DisplayNumber <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]

New-CsCommonAreaPhone -DN <ADObjectId> -LineUri <String> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayName <String>] [-DisplayNumber <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"

Como observado, novos telefones de área comum podem ser criados com o cmdlet New-CsCommonAreaPhone. New-CsCommonAreaPhone pode criar novos objetos de contato para uso com telefones de área comum ou pode associar objetos de contato existentes a um novo telefone de área comum. Para mais detalhes, consulte a descrição dos parâmetros OU e DN neste tópico.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-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 "New-CsCommonAreaPhone"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

LineUri

Obrigatório

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.

RegistrarPool

Obrigatório

Cadeia de caracteres

FQDN (nome de domínio totalmente qualificado) do pool do Registrador onde o objeto de contato deve ser hospedado. Por exemplo: -RegistrarPool "atl-cs-001.litwareinc.com".

Description

Opcional

Cadeia de caracteres

Permite a definição do atributo Description (descrição) do Active Directory para o telefone de área comum. Por sua vez, isso oferece uma maneira de se fornecer informações adicionais sobre o telefone; por exemplo, você pode querer fornecer detalhes sobre quem contatar em caso de problemas com o telefone.

DisplayName

Opcional

Cadeia de caracteres

Permite a definiçã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.

DN

Opcional

Nome diferenciado do Active Directory

Permite a associação de um objeto de contato existente do Active Directory a um novo telefone de área comum. Se houver um objeto de contato que você deseje associar a um telefone de área comum, use o parâmetro DN seguido do nome diferenciado do contato. Por exemplo: -DN "cn=Building 14 Lobby,dc=litwareinc,dc=com". Observe que seu comando irá falhar se o contato especificado não existir. Seu comando irá falhar se o contato especificado já tiver sido habilitado para o Lync Server. Nesse caso, primeiro desabilite o contato usando Disable-CsUser e depois execute New-CsCommonAreaPhone.

O parâmetro DN é particularmente útil em organizações que já tenham criado objetos de contato para salas de conferência e outras entidades. Esses contatos geralmente são usados para fins de agendamento. O parâmetro DN permite criar um novo telefone de área comum usando um desses objetos de contato pré-existentes.

Não é possível usar os parâmetros OU e DN no mesmo comando.

OU

Opcional

Nome diferenciado do Active Directory

Nome diferenciado da OU (unidade organizacional) do Active Directory onde o objeto de contato deve estar localizado. Por exemplo: -OU "ou=Redmond,dc=litwareinc,dc=com”.

Se o parâmetro OU for incluído, um novo contato será criado na OU (unidade organizacional) especificada, e o contato será atribuído automaticamente a um GUID (identificador global exclusivo) como seu nome comum. Com isso, o objeto de contato terá um nome semelhante a: {ce84964a-c4da-4622-ad34-c54ff3ed361f}.

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

Nenhuma. New-CsCommonAreaPhone não aceita entrada em pipeline.

Tipos de Retorno

New-CsCommonAreaPhone cria novas instâncias do objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact.

Exemplo

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

New-CsCommonAreaPhone -LineUri tel:+14255556710 -RegistrarPool redmond-cs-001.litwareinc.com -DisplayName "Building 14 Lobby" -OU "ou=Telecommunications,dc=litwareinc,dc=com"

O comando mostrado no Exemplo 1 cria um novo telefone de área comum para o número de telefone 1-425-555-6710 (observe que LineUri deve ser especificado no formato E.164). Além de especificar o número do telefone, o comando também especifica o pool do Registrador (RegistrarPool); o nome para exibição no Active Directory (DisplayName); e o nome diferenciado da OU na qual o objeto de contato correspondente deve ser criado (OU).

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

New-CsCommonAreaPhone -LineUri tel:+14255556710 -RegistrarPool redmond-cs-001.litwareinc.com -DN "cn=Building 14 Lobby,ou=Telecommunications,dc=litwareinc,dc=com"

O comando mostrado no Exemplo 2 é uma variação do comando mostrado no Exemplo 1. No Exemplo 2, porém, o novo telefone de área comum está associado a um objeto de contato existente do Active Directory. Para isso, o comando emprega o parâmetro DN em vez do parâmetro OU, usando o nome diferenciado do objeto de contato existente (cn=Building 14 Lobby,ou=Telecommunications,dc=litwareinc,dc=com) como valor do parâmetro. Neste comando, DisplayName também é deixado de fora; isso significa que o novo telefone de área comum usará o nome para exibição atribuído ao objeto de contato existente.