Compartilhar via

  • Artigo

Set-CsUCPhoneConfiguration

 

Tópico modificado em: 2012-03-26

Permite modificar opções de gerenciamento do Microsoft Lync 2010 Phone Edition. Isso inclui o modo de segurança necessário e se o telefone deve ser bloqueado automaticamente ou não depois de um período de inatividade especificado.

Sintaxe

Set-CsUCPhoneConfiguration [-Identity <XdsIdentity>] [-CalendarPollInterval <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnforcePhoneLock <$true | $false>] [-Force <SwitchParameter>] [-LoggingLevel <Off | Low | Medium | High>] [-MinPhonePinLength <Byte>] [-PhoneLockTimeout <TimeSpan>] [-SIPSecurityMode <Low | Medium | High>] [-Voice8021p <Byte>] [-VoiceDiffServTag <Byte>] [-WhatIf [<SwitchParameter>]]

Set-CsUCPhoneConfiguration [-CalendarPollInterval <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnforcePhoneLock <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LoggingLevel <Off | Low | Medium | High>] [-MinPhonePinLength <Byte>] [-PhoneLockTimeout <TimeSpan>] [-SIPSecurityMode <Low | Medium | High>] [-Voice8021p <Byte>] [-VoiceDiffServTag <Byte>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O Lync 2010 Phone Edition representa a combinação entre o telefone e o Microsoft Lync 2010. O Lync 2010 Phone Edition utiliza hardware especial (ou seja, um telefone compatível com o Lync 2010), que pode funcionar como um telefone de Voz sobre Protocolo de Internet (VoIP). Além disso, este hardware também pode atuar como um ponto de extremidade similar ao Lync 2010: é possível definir o seu status atual, verificar o status de contatos do Lync 2010, procurar novos contatos e realizar muitas outras atividades que você está acostumado a efetuar com o Lync 2010.

Os cmdlets CsUCPhoneConfiguration permitem utilizar definições de configuração para gerenciar os telefones que estiverem executando o Lync 2010 Phone Edition. Por exemplo: é possível controlar itens como o tamanho mínimo do número de identificação pessoal (PIN) usado para fazer o logon no telefone, e se o telefone será bloqueado ou não automaticamente após um tempo especificado de inatividade.

As definições de configuração dos telefones UC podem ser aplicadas nos escopos global ou de site Quando se instala o Lync Server pela primeira vez, cria-se um único conjunto de definições de telefones UC, que é aplicado no escopo global. no entanto, a qualquer momento depois disso, o cmdlet New-CsUCPhoneConfiguration pode ser usado para criar uma coleção de definições que são aplicadas no escopo de site. Isso permite ajustar o gerenciamento de telefones UC às necessidades exclusivas de cada site.

Além de criar novas coleções de definições de telefones UC, também é possível utilizar o cmdlet Set-CsUCPhoneConfiguration para modificar os valores de propriedade de uma coleção existente. Por exemplo, por padrão, o registro em telefones UC está desabilitado. Para habilitar o registro no nível global, é possível utilizar Set-CsUCPhoneConfiguration, para alterar para True o valor da propriedade LoggingLevel da coleção global.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

Representa o identificador exclusivo atribuído à coleção de definições de configuração de telefones UC. Para fazer referência às definições globais, utilize esta sintaxe: -Identity global. Para fazer referência a uma coleção configurada no escopo de site, utilize uma sintaxe semelhante a esta: -Identity site:Redmond. Observe que não é possível utilizar caracteres curingas ao se especificar uma Identidade.

Se esse parâmetro for omitido, Set-CsUCPhoneConfiguration modificará as definições globais.

Instance

Opcional

Objeto UcPhoneSettings

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.

CalendarPollInterval

Opcional

TimeSpan

Indica a frequência com que o dispositivo UC recupera as informações do calendário do Microsoft Outlook. O valor deve ser especificado utilizando-se o formato horas:minutos:segundos. Por exemplo, para definir o intervalo de tempo para uma hora (o maior intervalo permitido), utilize esta sintaxe: -CalendarPollInterval "01:00:00". O valor padrão é três minutos (00:03:00).

EnforcePhoneLock

Opcional

Booleano

Determina se os telefones UC serão bloqueados automaticamente ou não depois do número de minutos especificado por PhoneLockTimeout. O valor padrão é True.

LoggingLevel

Opcional

Cadeia de caracteres

Permite o logon no dispositivo UC. Os valores válidos são Off, Low, Medium e High. O valor padrão é Off.

MinPhonePinLength

Opcional

Byte

Especifica o número mínimo de dígitos exigidos nos números de identificação pessoal (PINs).

Valor mínimo: 4

Valor máximo: 15

Padrão: 6

PhoneLockTimeout

Opcional

Timespan

Especifica o período de tempo, em minutos, que um telefone UC permanecerá ocioso antes de se bloquear automaticamente.

Este valor deve ser menor do que 01:00:00 (uma hora). O valor padrão é 00:10:00 (dez minutos).

SIPSecurityMode

Opcional

SIPSecurityMode

Especifica o nível de segurança que o servidor aplica às sessões SIP iniciadas por um telefone UC.

Os valores válidos são:

Low (permite qualquer tipo de autorização ou transporte).

Medium (NTLM ou Kerberos são obrigatórios para a autenticação dos usuários).

High (NTLM ou Kerberos são obrigatórios para a autenticação dos usuários e TLS é necessário para as conexões SIP).

O valor padrão é High.

Voice8021p

Opcional

Byte

Especifica o valor da prioridade do usuário (o valor 802.1p) para tráfego de voz na implantação do Lync Server.

Esta definição será efetiva somente nas redes nas quais os comutadores e as pontes oferecerem apoio ao 802.1p. O valor mínimo desta propriedade é 0 e o valor máximo, 7. O valor padrão é 0.

VoiceDiffServTag

Opcional

Byte

Especifica a representação decimal da marcação prioritária do Ponto de código de serviços diferenciados de seis bits (DSCP) Essa marcação define o Comportamento por salto (PHB) de pacotes de IP passados pelos telefones UC que forem gerenciados por esse servidor.

Este valor deve estar entre 0 e 63, inclusive. O valor padrão é 40.

Force

Opcional

Parâmetro de opção

Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.

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.WritableConfig.Policy.Voice.UcPhoneSettings. Set-CsUCPhoneConfiguration aceita instâncias canalizadas do objeto de definições de telefone UC.

Tipos de Retorno

Set-CsUCPhoneConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings.

Exemplo

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

Set-CsUCPhoneConfiguration -Identity global -SIPSecurityMode "Medium"

O comando exibido no Exemplo 1 define como Médio o modo de segurança SIP das definições globais de telefone UC.

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

Set-CsUCPhoneConfiguration -Identity site:Redmond -PhoneLockTimeout "00:30:00"

O comando anterior modifica as definições de telefone UC configuradas para o site de Redmond. Nesse caso, a propriedade PhoneLockTimeout será definida como 30 minutos; isso é feito incluindo-se o parâmetro PhoneLockTimeout e o valor de parâmetro "00:30:00" (00 horas: 30 minutos: 00 segundos).

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

Get-CsUCPhoneConfiguration -Filter "site:*" | Set-CsUCPhoneConfiguration -PhoneLockTimeout "00:30:00"

O Exemplo 3 é uma variação do comando exibido no Exemplo 2. No entanto, dessa vez, a propriedade PhoneLockTimeout será modificada em todas as definições de telefone UC configuradas no escopo de site. Para isso, o comando inicialmente chama Get-CsUCPhoneConfiguration. O parâmetro Filter e o valor de filtro "site:*" limitam os dados retornados às definições de telefone configuradas no escopo de site. Essa coleção filtrada será então canalizada para Set-CsUCPhoneConfiguration, que utilizará o parâmetro PhoneLockTimeout e o valor de parâmetro "00:30:00" (00 horas: 30 minutos: 00 segundos), para definir como 30 minutos o valor de tempo limite para bloqueio do telefone de cada item na coleção.

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

Get-CsUCPhoneConfiguration | Where-Object {$_.SIPSecurityMode -ne "High"} | Set-CsUCPhoneConfiguration -EnforcePhoneLock $True -PhoneLockTimeout "00:30:00"

O comando anterior configura as propriedades EnforcePhoneLock e PhoneLockTimeout de todas as definições de telefone UC cujo modo de segurança SIP estiver definido como Baixo ou Médio. Para realizar essa tarefa, o comando usa primeiramente Get-CsUCPhoneConfiguration, para retornar todas as definições de configuração de telefone UC na organização. Essas informações serão então canalizadas para o cmdlet Where-Object, que selecionará as definições cuja propriedade SIPSecurityMode não for igual a Alta (como a segurança de SIP somente pode ser definida como Baixa, Média ou Alta, essa cláusula selecionará todas as definições nas quais SIPSecurityMode for definida como Baixa ou Média ). A coleção filtrada será então canalizada para Set-CsUCPhoneConfiguration, que utilizará os parâmetros EnforcePhoneLock e PhoneLockTimeout para modificar as propriedades de bloqueio do telefone e de tempo limite de bloqueio do telefone.

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

Get-CsUCPhoneConfiguration | Where-Object {$_.PhoneLockTimeout -lt "00:10:00"} | Set-CsUCPhoneConfiguration -PhoneLockTimeout "00:10:00"

No Exemplo 5, define-se como dez minutos o valor de tempo limite de bloqueio de telefone em todas as definições de telefone UC nas quais a propriedade PhoneLockTimeout for menor que dez minutos (na verdade, isso torna dez minutos o valor mínimo de tempo limite de bloqueio do telefone em toda a organização). Para fazer isso, o comando usa primeiramente Get-CsUCPhoneConfiguration, para retornar uma coleção de todas as definições de telefones UC em uso na organização. Essa coleção será então canalizada para Where-Object, que selecionará apenas as definições cuja propriedade PhoneLockTimeout for menor do que 10 minutos (00 horas: 10 minutos: 00 segundos). Por sua vez, essa coleção filtrada será canalizada para Set-CsUCPhoneConfiguration, que definirá como dez minutos o valor de PhoneLockTimeout de cada item na coleção.