Compartilhar via


New-CsUCPhoneConfiguration

 

Tópico modificado em: 2012-03-26

Cria uma nova coleção de definições utilizadas para gerenciar o Microsoft Lync 2010 Phone Edition. Essas definições permitem configurar aspectos como o modo de segurança requerido e especificar se o telefone deveria ser bloqueado automaticamente ou não, após um período especificado de inatividade.

Sintaxe

New-CsUCPhoneConfiguration -Identity <XdsIdentity> [-CalendarPollInterval <TimeSpan>] [-Confirm [<SwitchParameter>]] [-EnforcePhoneLock <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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 (isto é, 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 às quais você estiver acostumado com o Lync 2010.

o Lync Server 2010 é enviado com alguns cmdlets, que permitem gerenciar os telefones executando o Lync 2010. Por exemplo: é possível controlar itens como o tamanho mínimo do número de identificação pessoal (PIN) utilizado para fazer o logon no telefone e se o telefone será bloqueado automaticamente ou não depois de um período especificado de inatividade.

As definições de configuração dos telefones do Unified Communications (UC) podem ser aplicadas no escopo global ou no escopo de site. (as definições aplicadas no escopo de site têm precedência sobre as definições aplicadas no escopo global). 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.

O cmdlet New-CsUCPhoneConfiguration permite criar novas definições de telefone UC no escopo de site. Observe que só pode haver uma coleção de definições por site. Por exemplo, suponha que se tente criar uma coleção de definições com a identidade site:Redmond, mas o site de Redmond já possui um conjunto de definições de telefone UC atribuídas a ele. Nesse caso, o comando falhará. Em vez disso, deve-se executar uma das duas opções a seguir: remova as definições existentes e, em seguida, utilize New-CsUCPhoneConfiguration, para criar uma nova coleção de definições; ou simplesmente utilize Set-CsUCPhoneConfiguration, para modificar as definições existentes.

Não é possível criar uma nova coleção de definições no escopo global. Em vez disso, a única coisa que pode ser feita no escopo global é usar Set-CsUCPhoneConfiguration para modificar as definições existentes.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Identidade de Xds

Representa o identificador exclusivo a ser atribuído à nova coleção de definições de configuração de telefones UC. Como só é possível criar novas coleções no escopo do site, a Identity sempre terá o prefixo "site:" seguido do nome do site; por exemplo "site:Redmond".

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

Habilita o logon no dispositivo UC. Os valores válidos são Desligado, Baixo, Médio e Alto. 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 2010.

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.

InMemory

Opcional

Parâmetro de opção

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

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

Nenhuma. New-CsUCPhoneConfiguration não aceita entradas canalizadas.

Tipos de Retorno

Cria instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Voice.UcPhoneSettings.

Exemplo

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

New-CsUCPhoneConfiguration -Identity site:Redmond -CalendarPollInterval "00:10:00" -LoggingLevel "Medium"

O comando anterior cria uma nova coleção de definições de telefone UC para o site de Redmond. Neste exemplo, dois parâmetros opcionais são incluídos, juntamente com o parâmetro obrigatório Identity: CalendarPollInterval, que define o período de sondagem do calendário a cada dez minutos (00 horas: 10 minutos: 00 segundos) e LoggingLevel, que define o nível de logon no telefone UC como Médio. Assim que este comando for concluído, serão aplicadas as novas definições ao site de Redmond e os telefones dos usuários desse site serão governados pelas novas definições. Observe que este comando falhará se o site de Redmond já tiver uma coleção de definições de telefones UC.

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

$x = New-CsUCPhoneConfiguration -Identity site:Redmond -InMemory
$x.CalendarPollInterval = "00:10:00" 
$x.LoggingLevel = "Medium"
Set-CsUCPhoneConfiguration -Instance $x

O Exemplo 2 mostra o uso do parâmetro InMemory. Este parâmetro permite criar um novo conjunto de definições de telefones UC somente na memória. (essas definições são armazenadas na variável $x). Após a criação desta coleção virtual, é possível modificar as definições na memória utilizando-se comandos similares aos mostrados nas linhas 2 e 3 do exemplo: na linha 2, a propriedade CalendarPollInterval é definida como dez minutos (00 horas: 10 minutos: 00 segundos) e na linha 3 a propriedade LoggingLevel é definida como Medium.

Depois que a modificação dos valores da propriedade tiver terminado, pode-se utilizar o cmdlet Set-CsUCPhoneConfiguration para transformar as definições virtuais armazenadas em $x em uma coleção real de definições aplicadas ao site de Redmond. Observe que, com a utilização do parâmetro InMemory, as definições não serão realmente aplicadas, até que se chame Set-CsUCPhoneConfiguration. Se este cmdlet não for chamado, as definições virtuais desaparecerão quando se encerrar a sessão do Windows PowerShell ou quando se excluir a variável $x.