Compartilhar via

  • Artigo

Get-CsCommonAreaPhone

 

Tópico modificado em: 2012-03-23

Retorna informações sobre os telefones de área comum gerenciados, usando-se Microsoft Lync Server 2010. Os telefones de área comum são telefones que estão localizados nos saguões dos edifícios, na área de descanso dos funcionários ou em outras áreas onde provavelmente são usados por diversas pessoas e para diferentes usos.

Sintaxe

Get-CsCommonAreaPhone [-Identity <UserIdParameter>] [-Filter <String>] [-LdapFilter <String>] [-OU <OUIdParameter>] [-DomainController <Fqdn>] [-Credential <PSCredential>] [-ResultSize <Unlimited`1>] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]

Descrição Detalhada

Os telefones de área comum são telefones de IP que não estão associados a um usuário específico. Em vez de estarem localizados no escritório de alguém, os telefones de área comum estão normalmente localizados nos saguões dos edifícios, cafeterias, áreas de descanso dos funcionários, salas de reunião e outros locais em que uma grande quantidade de pessoas costumam se reunir. Isso apresenta aos administradores um desafio de gerenciamento; isso ocorre porque o uso do telefone no Lync Server 2010 normalmente é mantido usando-se políticas de voz e planos de discagem que são atribuídos a usuários específicos. Os telefones de área comum não possuem usuários específicos a eles atribuídos.

A solução para esse desafio é criar objetos de contato no Active Directory em todos os telefones de área comum. (esses objetos de contato podem ser criados usando-se o cmdlet New-CsCommonAreaPhone). Como no caso das contas de usuários, é possível atribuir políticas e planos de voz a esses objetos de contato. Como resultado, será possível manter o controle sobre os telefones de área comum, mesmo se eles não estiverem associados a um usuário específico. Por exemplo: se você não quiser que as pessoas transfiram ou estacionem chamadas de um telefone de área comum, basta criar uma política de voz que proíba as transferências e os estacionamentos de chamadas e, em seguida, atribuir essa política ao telefone de área comum. (ou, mais corretamente, ao objeto de contato que representa o telefone de área comum). Por exemplo, esse comando atribui a política de voz CommonAreaPhoneVoicePolicy a todos os telefones de área comum:

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

Get-CsCommonAreaPhone permite recuperar informações sobre os telefones de área comum configurados para uso na organização. Se Get-CsCommonAreaPhone for chamado sem parâmetros, o cmdlet retornará informações sobre todos os telefones de área comum. Os parâmetros opcionais fornecem diversas formas de filtragem da informação. Por exemplo: é possível retornar todos os telefones de área comum que tiverem objetos de contato em uma unidade organizacional (OU) específica, ou todos os objetos de contato localizados em um edifício específico.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsCommonAreaPhone localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins e RTCUniversalReadOnlyAdmins. É possível atribuir permissões para executar esse cmdlet em sites específicos ou OUs específicas do Active Directory, usando-se o cmdlet Grant-CsOUPermission. 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 (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsCommonAreaPhone"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Parâmetro User ID

Identificador exclusivo do telefone de área comum. Os telefones de área comum são identificados mediante o uso de um nome diferenciado do objeto de contato associado no Active Directory. Por padrão, os telefones de área comum usam um identificador global exclusivo (GUID) como seu nome comum. Isso significa que os telefones normalmente terão uma identidade semelhante a essa: CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com.

Credential

Opcional

Objeto PS Credential

Permite executar o cmdlet Get-CsCommonAreaPhone com 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 de Credencial, você deve criar primeiro um objeto PSCredential usando o cmdlet Get-Credential. Para obter mais detalhes, consulte o tópico da Ajuda referente ao cmdlet Get-Credential.

DomainController

Opcional

Cadeia de caracteres

Permite que você se conecte a um controlador de domínio especificado, para recuperar as informações de contato. Para se conectar a um determinado controlador de domínio, inclua o parâmetro DomainController, seguido do nome de domínio totalmente qualificado (FQDN) desse computador (atl-cs-001.litwareinc.com, por exemplo).

Filter

Opcional

Cadeia de caracteres

Permite limitar os dados retornados, filtrando-se atributos específicos a Lync Server 2010. Por exemplo, é possível limitar os dados retornados a objetos de contato do telefone de área comum aos quais tenha sido atribuída uma política de voz específica, ou a contatos aos quais não tenha sido atribuída uma política de voz específica.

O parâmetro Filter usa a mesma sintaxe de filtragem Windows PowerShell utilizada pelo cmdlet Where-Object.

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 2010). Por exemplo, é possível limitar os dados retornados a objetos de contato aos quais tenha sido atribuído um departamento específico ou que estejam localizados em um edifício específico.

Ao criar filtros, o parâmetro LdapFilter usa a linguagem de consulta LDAP. Por exemplo, um filtro que retorna apenas objetos de contato representando telefones de área comum na cidade de Redmond poderia ter a seguinte aparência:

-LDAPFilter "l=Redmond"

No filtro anterior, "l" (a letra L minúscula) representa o atributo do Active Directory (localidade); "=", o operador de comparação (igual a) e "Redmond", o valor de filtro.

OU

Opcional

Nome diferenciado do Active Directory

Permite retornar objetos de contato de uma unidade organizacional (OU) específica do Active Directory. O parâmetro OU retorna dados da OU especificada e de qualquer de suas OUs filhas. Por exemplo: se a OU Financeira tiver duas OUs filhas, AccountsPayable e AccountsReceivable, serão retornadas informações sobre telefones de área comum de cada uma das OUs.

Especificando um OU, use o nome diferenciado daquele contêiner; por exemplo: -OU "OU=Finance,dc=litwareinc,dc=com".

ResultSize

Opcional

Inteiro

Permite limitar o número de registros retornados por um comando. Por exemplo: para retornar sete telefones de área comum (independentemente de quantos telefones de área comum existam 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 telefones retornados. Se você definir o ResultSize como 7, mas só houver três telefones de área comum na floresta, o comando retornará os três telefones 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-CsCommonAreaPhone aceita um valor canalizado de cadeia de caracteres, que representa a Identidade do telefone de área comum.

Tipos de Retorno

Get-CsCommonAreaPhone retorna instâncias do objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact.

Exemplo

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

Get-CsCommonAreaPhone

O comando exibido no Exemplo 1 retorna informações sobre todos os telefones de área comum configurados para uso na organização. Isto é feito chamando-se Get-CsCommonAreaPhone, sem qualquer parâmetro.

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

Get-CsCommonAreaPhone -Filter {DisplayName -eq "Building 14 Lobby"}

No Exemplo 2, retorna-se o telefone de área comum cujo nome de exibição no Active Directory for "Saguão do Edifício 14". Essa tarefa é realizada incluindo-se o parâmetro Filter e o valor de filtro {DisplayName -eq "Saguão do Edifício 14"}. Esse valor de filtro limita os objetos retornados a telefones de área comum cuja propriedade DisplayName for igual a "Saguão do Edifício 14".

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

Get-CsCommonAreaPhone  -Filter {DisplayName -like "Building 14*"}

O comando anterior retorna todos os telefones de área comum que possuírem um nome de exibição no Active Directory que comece com os caracteres "Edifício 14". Para fazer isso, chama-se Get-CsCommonAreaPhone, juntamente com o parâmetro Filter e o valor de filtro {DisplayName -like "Edifício 14*"}. O valor de filtro utiliza o operador -like e a cadeia de caracteres curinga "Edifício 14*" para limitar os dados retornados aos telefones cuja propriedade DisplayName começar com "Edifício 14" (por exempo, "Saguão do Edifício 14", "Cafeteria do Edifício 14", etc.).

-------------------------- Exemplo 4 ------------------------

Get-CsCommonAreaPhone  -Filter {LineUri -eq "tel:+14255551234"}

No Exemplo 4, é retornado um único telefone de área comum: o telefone que possui a propriedade LineUri igual a "tel:+14255551234". Como LineUris deve ser exclusiva, este comando nunca retornará mais do que um único item.

-------------------------- Exemplo 5 ------------------------

Get-CsCommonAreaPhone -Filter {DialPlan -eq $Null}

O comando exibido no Exemplo 5 retorna informações sobre todos os telefones de área comum aos quais não tiver sido atribuído um plano de discagem. Isso é realizado usando-se o parâmetro Filter e o valor de filtro {DialPlan -eq $Null}, que limita os dados retornados aos telefones cuja propriedade DialPlan for igual a um valor nulo. Se um plano de discagem não tiver sido atribuído explicitamente a um telefone de área comum, o telefone usará automaticamente o plano de discagem global ou, se existir, o plano de discagem atribuído ao site.

-------------------------- Exemplo 6 ------------------------

Get-CsCommonAreaPhone -OU "ou=Telecommunications,dc=litwareinc,dc=com"

O comando anterior retorna uma coleção de todos os telefones de área comum que tiverem um objeto de contato na OU Telecomunicações do Serviços de Domínio Active Directory (AD DS). Para fazer isso, chama-se Get-CsCommonAreaPhone, juntamente com o parâmetro OU. O valor do parâmetro limita os objetos retornados aos telefones que tiverem objetos de contato na OU cujo nome diferenciado for ou=Telecommunications,dc=litwareinc,dc=com.