Compartilhar via

  • Artigo

Remove-CsCommonAreaPhone

 

Tópico modificado em: 2012-03-27

Remove um telefone de área comum da coleção de telefones gerenciados, usando-seMicrosoft 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

Remove-CsCommonAreaPhone [-Identity] <UserIdParameter> [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>] [-WhatIf] [-Confirm]

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 um grande número de pessoas costuma 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.

Uma solução para esse desafio é criar objetos de contato do 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"

De tempos em tempos, pode ser necessário excluir o objeto de contato associado a um telefone de área comum. Por exemplo, caso se remova o telefone de uma área de descanso de funcionários, não será mais necessário um objeto de contato associado a esse telefone. O cmdlet Remove-CsCommonAreaPhone permite excluir telefones de área comum. Ao se executar esse cmdlet, o telefone será excluído da lista de telefones de área comum retornados por Get-CsCommonAreaPhone. Além disso, o objeto de contato associado a esse telefone será excluído do Serviços de Domínio Active Directory (AD DS).

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsCommonAreaPhone localmente: RTCUniversalUserAdmins. É possível atribuir permissões para executar esse cmdlet em sites específicos ou unidades organizacionais (OUs) específicas do Active Directory, usando o cmdlet Grant-CsOUPermission. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

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. Por isso, talvez seja mais fácil recuperar os telefones de área comum utilizando-se o cmdlet Get-CsCommonAreaPhone e, em seguida, canalizando-se os objetos retornados para Remove-CsCommonAreaPhone.

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

Objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact. Remove-CsCommonAreaPhone aceita instâncias canalizadas do objeto de telefone de área comum.

Tipos de Retorno

Remove-CsCommonAreaPhone exclui instâncias existentes do objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSADCommonAreaPhoneContact.

Exemplo

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

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

O comando exibido no Exemplo 1 exclui o telefone de área comum que possuir o nome de exibição "Saguão do Edifício 14". Para isso, o comando primeiramente chama Get-CsCommonAreaPhone, juntamente com o parâmetro Filter e o valor de filtro "{DisplayName -eq "Saguão do Edifício 14"}". O objeto retornado será então canalizado para o cmdlet Remove-CsCommonAreaPhone, que o excluirá.

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

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

No Exemplo 2, o comando exclui todos os telefones de área comum que não tiverem recebido a atribuição de um plano de discagem. Essa tarefa é realizada primeiramente utilizando-se Get-CsCommonAreaPhone e o parâmetro Filter, para retornar os itens especificados. O valor de filtro {DialPlan -eq $Null} limita os dados retornados aos telefones de área comum que não tiverem recebido a atribuição de um plano de discagem. Esta coleção filtrada será então canalizada para Remove-CsCommonAreaPhone, que excluirá cada telefone na coleção.

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

Get-CsCommonAreaPhone -OU "ou=Redmond,dc=litwareinc,dc=com" | Remove-CsCommonAreaPhone

O Exemplo 3 exclui todos os telefones de área comum cujos objetos de contato estiverem localizados na OU Redmond do Active Directory. Para realizar essa tarefa, o Get-CsCommonAreaPhone é inicialmente chamado para retornar todos os telefones de área comum cujos objetos de contato na OU Redmond; o parâmetro OU e o valor de parâmetro "ou=Redmond,dc=litwareinc,dc=com” são usados para limitar os dados retornados à unidade organizacional especificada. O conjunto retornado será canalizado para Remove-CsCommonAreaPhone, que excluirá cada telefone nesse conjunto.