Compartilhar via

  • Artigo

Remove-CsUCPhoneConfiguration

 

Tópico modificado em: 2012-03-26

Remove a coleção especificada de definições de configuração do Microsoft Lync 2010 Phone Edition. Essas configurações incluem coisas como o modo de segurança obrigatório, bem como se o telefone deve ser bloqueado automaticamente após um período especificado de inatividade.

Sintaxe

Remove-CsUCPhoneConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O Lync 2010 Phone Edition representa a fusão do telefone ao Microsoft Lync 2010. O Lync 2010 Phone Edition usa um hardware especial (ou seja, um telefone compatível com o Lync 2010) capaz de funcionar como um telefone VoIP. Além disso, esse hardware também pode funcionar como um ponto de extremidade semelhante ao Lync 2010: é possível definir o status atual; verificar o status dos contatos do Lync 2010; procurar novos contatos e realizar muitas das outras atividades que você está acostumado a fazer com o Lync.

O Microsoft Lync Server 2010 acompanha vários cmdlets que permitem gerenciar telefones executando o Lync 2010; por exemplo, é possível controlar coisas como o tamanho mínimo do número PIN usado para fazer logon no telefone e se o telefone se bloqueará automaticamente ou não após um período especificado de inatividade.

As definições de configuração do telefone de UC (comunicações unificadas) podem ser aplicadas no escopo global ou do site. (As configurações aplicadas no escopo do site têm precedência sobre as configurações aplicadas no escopo global.) Quando você instalar o Lync Server 2010 pela primeira vez, um único conjunto de definições de configuração do telefone de UC será criado e aplicado no escopo global. No entanto, a qualquer momento depois disso, será possível usar o cmdlet New-CsUCPhoneConfiguration para criar uma coleção de configurações aplicadas no escopo do site. Isso permite personalizar o gerenciamento do telefone de UC de acordo com as necessidades exclusivas de cada site individual.

Posteriormente, as configurações criadas usando-se New-CsUCPhoneConfiguration poderão ser removidas com o cmdlet Remove-CsUCPhoneConfiguration. Ao remover configurações de um site, os telefones executando o Lync 2010 nesse site não ficarão sem gerenciamento; em vez disso, esses telefones ficarão automaticamente sob a jurisdição das configurações globais.

Também é possível executar Remove-CsUCPhoneConfiguration com as configurações globais. No entanto, se você fizer isso, as configurações globais não serão efetivamente removidas: não é possível remover as configurações globais do telefone de UC. Em vez disso, serão restaurados os valores padrão das propriedades nas configurações globais. Por exemplo, se você tiver alterado o intervalo do tempo de bloqueio do telefone para 30 minutos, a "remoção" das configurações globais redefinirá o intervalo para o valor padrão de 10 minutos.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsIdentity

Identificador exclusivo da coleção de definições de configuração do telefone de UC a ser removida. Para remover uma coleção de sites, use uma sintaxe semelhante a esta: -Identity "site:Redmond". Para remover (redefinir) a coleção global, use a seguinte sintaxe: -Identity global. Observe não ser possível usar curingas durante a especificação de uma Identity de diretiva.

Force

Opcional

Parâmetros de opção

Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando.

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.WritableConfig.Policy.Voice.UcPhoneSettings. Remove-CsUCPhoneConfiguration aceita instâncias em pipeline do objeto de configurações do telefone de UC.

Tipos de Retorno

Nenhuma. Em vez disso, o cmdlet remove instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings.

Exemplo

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

Remove-CsUCPhoneConfiguration -Identity site:Redmond

O comando mostrado no Exemplo 1 remove as definições de configuração do telefone de UC para o site de Redmond (-Identity site:Redmond). Quando as configurações forem removidas do escopo de um site, os usuários nesse site terão seus telefones UC governados pelas definições de configuração de telefone globais.

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

Get-CsUCPhoneConfiguration -Filter site:* | Remove-CsUCPhoneConfiguration

O Exemplo 2 remove todas as configurações do telefone de UC definidas no escopo do site. Para isso, o comando usa inicialmente Get-CsUCPhoneConfiguration e o parâmetro Filter para retornar todas as definições configuradas no escopo do site; o valor de filtro "site:*" limita os dados retornados a configurações nas quais a propriedade Identity (a única pela qual é possível filtrar) comece com o valor da cadeia de caracteres "site:". Esta coleção filtrada é então passada para Remove-CsUCPhoneConfiguration, que remove cada item na coleção.

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

Get-CsUCPhoneConfiguration | Where-Object {$_.EnforcePhoneLock -eq $False} | Remove-CsUCPhoneConfiguration

No Exemplo 3, todas as configurações do telefone de UC que não impuserem o bloqueio do telefone são removidas. Para realizar essa tarefa, o comando chama inicialmente Get-CsUCPhoneConfiguration sem nenhum parâmetro para retornar uma coleção de todas as configurações do telefone de UC atualmente em uso na organização. Essa coleção é redirecionada para o cmdlet Where-Object, que separa apenas as configurações nas quais a propriedade EnforceLockProperty seja igual a False. Por sua vez, essa coleção filtrada é redirecionada para Remove-CsUCPhoneConfiguration, que remove cada item da coleção.

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

Get-CsUCPhoneConfiguration | Where-Object {$_.SIPSecurityMode -ne "High"} | Remove-CsUCPhoneConfiguration

O comando anterior exclui todas as definições de configuração do telefone de UC nas quais o modo de segurança SIP esteja definido como Low (baixo) ou Medium (médio). Para isso, Get-CsUCPhoneConfiguration é inicialmente chamado para retornar uma coleção de todas as definições do telefone de UC configuradas para uso na organização. Em seguida, essa coleção é redirecionada para Where-Object, que seleciona apenas as configurações nas quais a propriedade SIPSecurityMode esteja definida como Low ou Medium; isso é feito selecionando-se essas configurações nas quais SIPSecurityMode seja diferente de High (existem três valores possíveis para SIPSecurityMode: Low, Medium e High.) Em seguida, a coleção filtrada é redirecionada para Remove-CsUCPhoneConfiguration, que exclui todas as configurações nas quais SIPSecurityMode seja diferente de High.