Compartilhar via

  • Artigo

Get-CsUCPhoneConfiguration

 

Tópico modificado em: 2012-03-23

Retorna informações sobre as opções de gerenciamento do Microsoft Lync 2010 Phone Edition. Isso inclui coisas como o modo de segurança necessário e se o telefone deve ou não ser bloqueado automaticamente após um período especificado sem atividade.

Sintaxe

Get-CsUCPhoneConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsUCPhoneConfiguration [-Filter <String>] [-LocalStore <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 está acostumado a fazer com o Lync 2010.

Os cmdlets CsUCPhoneConfiguration permitem gerenciar os telefones com o Lync 2010; por exemplo, é possível controlar coisas como o tamanho mínimo do 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 podem ser aplicadas no escopo global ou de site. (As configurações aplicadas no escopo do site têm precedência sobre as configurações aplicadas no escopo global.) O cmdlet Get-CsUCPhoneConfiguration permite a obtenção de informações sobre as definições de configuração do telefone empregadas no momento em toda a sua organização.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Xds Identity

Indica o identificador exclusivo da coleção de configurações de telefone UC (comunicações unificadas) que você deseja retornar. Para se referir às configurações globais, use esta sintaxe: -Identity global. Para se referir a uma coleção configurada em escopo de site, use uma sintaxe semelhante a esta: -Identity "site:Redmond". Observe não ser possível usar curingas durante a especificação de uma Identity. Se for necessário usar curingas, inclua o parâmetro -Filter, no lugar.

Se esse parâmetro não for especificado, Get-CsUCPhoneConfiguration retornará uma coleção de todas as configurações de telefone UC em uso na organização.

Filter

Opcional

Cadeia de caracteres

Permite o uso de caracteres curinga para retornar uma coleção (ou coleções) de configurações de telefone UC. Para retornar uma coleção de todas as configurações definidas em escopo de site, use esta sintaxe: -Filter site:*. Para retornar uma coleção de todas as configurações que tenham o valor de cadeia de caracteres "EMEA" em algum lugar de sua propriedade Identity (a única que pode ser filtrada), use esta sintaxe: -Filter *EMEA*.

LocalStore

Opcional

Parâmetros de Opção

Obtém os dados de configuração do telefone UC a partir da réplica local do Repositório de Gerenciamento Central, e não do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsUCPhoneConfiguration não aceita entrada em pipeline.

Tipos de Retorno

Get-CsUCPhoneConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings.

Exemplo

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

Get-CsUCPhoneConfiguration

O comando mostrado no Exemplo 1 retorna todas as configurações de telefone UC em uso no momento na organização. Usar Get-CsUCPhoneConfiguration sem parâmetros sempre retorna uma coleção completa de configurações de telefone.

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

Get-CsUCPhoneConfiguration -Identity site:Redmond

No Exemplo 2, apenas as configurações de telefone UC que tenham Identity site:Redmond são retornadas. Como as identidades precisam ser únicas, este comando nunca retornará mais de uma coleção de configurações de telefone.

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

Get-CsUCPhoneConfiguration -Filter site:*

No comando anterior, todas as configurações de telefone UC que tenham sido definidas em escopo de site são retornadas. Para fazer isso, Get-CsUCPhoneConfiguration é chamado, junto com o parâmetro -Filter; o valor de filtro "site:*" limita os dados retornados às configurações nas quais a propriedade Identity (a única propriedade que pode ser filtrada) comece com o valor de cadeia de caracteres "site:". Por definição, configurações que tenham Identity começando com o valor de cadeia de caracteres "site:" são configurações que foram definidas em escopo de site.

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

Get-CsUCPhoneConfiguration | Where-Object {$_.SIPSecurityMode -eq "Medium"}

O exemplo 4 retorna as configurações de telefone UC em que o modo de segurança SIP estiver definido como Média. (A segurança do SIP pode ser definida como Baixa, Média ou Alta.) Para executar esta tarefa, o comando primeiro usa Get-CsUCPhoneConfiguration sem nenhum parâmetro adicional para retornar uma coleção de todas as configurações de telefone UC definidas para uso na organização. Esta coleção é então canalizada para o cmdlet Where-Object, que seleciona apenas as configurações nas quais a propriedade SIPSecurityMode seja igual a Medium (médio).

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

Get-CsUCPhoneConfiguration | Where-Object {$_.EnforcePhoneLock -eq $False -or $_.MinPhonePinLength -lt 6}

No Exemplo 5, são retornadas as configurações de telefone UC que atendam a um dos ou a ambos os critérios a seguir: 1) o bloqueio do telefone não é aplicado; e/ou 2) o tamanho mínimo do PIN é menor que seis dígitos. Para fazer isso, o comando primeiro chama Get-CsUCPhoneConfiguration para retornar uma coleção de todas as configurações de telefone UC em uso na organização. Essa coleção é então canalizada para o Where-Object, que seleciona os itens que atendam a um dos (ou ambos os) critérios a seguir: 1) a propriedade EnforcePhoneLock é igual a False; e/ou 2) a propriedade MinPhoneLength é menor do que 6.

O operador -or diz ao Where-Object para selecionar configurações que atendam a um dos (ou a ambos os) critérios. Para selecionar configurações que atendam a ambos os critérios (no caso, sem aplicação do bloqueio do telefone e com um PIN de tamanho inferior a 6) use o operador -and:

Where-Object {$_.EnforcePhoneLock -eq $False -and $_.MinPhonePinLength -lt 6}