Partilhar via

  • Artigo

New-CsDeviceUpdateConfiguration

 

Tópico modificado em: 2012-03-23

Cria uma nova instância das definições de configuração de atualização do dispositivo. Essas configurações são usadas para gerenciar o Serviço Web de Atualização de Dispositivos, um componente do Microsoft Lync Server 2010 que permite aos administradores distribuir atualizações de firmware para telefones e outros dispositivos nos quais o Microsoft Lync 2010 Phone Edition esteja em execução.

Sintaxe

New-CsDeviceUpdateConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LogCleanUpInterval <TimeSpan>] [-LogCleanUpTimeOfDay <Nullable>] [-LogFlushInterval <TimeSpan>] [-MaxLogCacheLimit <UInt32>] [-MaxLogFileSize <UInt32>] [-ValidLogFileExtensions <PSListModifier>] [-ValidLogFileTypes <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O Serviço Web de Atualização de Dispositivos oferece aos administradores uma maneira de distribuir atualizações de firmware para dispositivos nos quais o Lync 2010 Phone Edition esteja em execução. Os administradores carregam periodicamente um conjunto de regras de atualização de dispositivos para o Lync Server 2010. Depois de testadas e aprovadas, essas regras podem ser aplicadas aos dispositivos apropriados assim que eles são conectados ao sistema. Os dispositivos procuram por atualizações ao serem ligados pela primeira vez, e tornam a procurar quando um usuário faz logon. Desse ponto em diante, os dispositivos buscam atualizações a cada 24 horas.

As definições de configuração de dispositivo, que são usadas para gerenciar o Serviço Web de Atualização de Dispositivos, podem ser atribuídas ao nível global ou ao escopo do site. Para criar uma nova coleção de configurações para um site, use o cmdlet New-CsDeviceUpdateConfiguration. Observe só ser possível criar novas configurações no escopo do site; haverá falha no comando se você tentar criar uma nova coleção de configurações no escopo global. Além disso, haverá falha no comando se você tentar criar uma nova coleção de configurações para, digamos, o site de Redmond e esse site já tiver uma coleção de definições de configuração de atualização do dispositivo. Isso porque só é possível ter uma coleção de definições de configuração de atualização do dispositivo por site.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Xds Identity

Indica a Identity das novas definições de configuração de atualização do dispositivo. Como as novas configurações só podem ser criadas no escopo do site, a Identidade será semelhante a esta: -Identity "site:Redmond".

LogCleanUpInterval

Opcional

Timespan

Especifica o tempo em que um arquivo de log de atualização do dispositivo é mantido antes de ser excluído pelo sistema.

O valor deve ser inserido no formato dd.hh:mm:ss, onde dd são dias, hh são horas, mm são minutos e ss são segundos. Para inserir apenas dias, você deve usar um ponto final (.) depois do valor.

Valor mínimo: 1.00:00:00 (1 dia)

Valor máximo: 365.00:00:00 (1 ano)

Padrão: 10.00:00:00 (10 dias)

LogCleanUpTimeOfDay

Opcional

DateTime

Indica a hora do dia na qual o sistema verifica se há algum arquivo de log expirado que deva ser excluído. (arquivos de log expirados são todos os arquivos anteriores ao valor especificado pela propriedade LogCleanupInterval).

O valor passado para o parâmetro LogCleanupTimeOfDay deve estar no formato 24 horas hh:mm, onde hh representa as horas e mm representa os minutos. Nesse formato, a meia-noite é representada como 00:00, 8:30 A.M. é representado como 08:30 e 11:52 P.M. como 23:52. O valor padrão é nulo.

LogFlushInterval

Opcional

TimeSpan

Indica com que frequência as informações armazenadas no cache do arquivo de log são gravadas no arquivo de log real. Por padrão, as informações de atualização do dispositivo não são gravadas imediatamente no arquivo de log; essas informações são armazenadas em cache na memória até: 1) o intervalo de liberação do log expirar ou 2) o cache atingir seu tamanho máximo. Se o valor for definido como 10 minutos (00:10:00), as informações no cache serão gravadas no arquivo de log a cada 10 minutos. Depois que os dados forem registrados, o cache será limpo.

O valor deve ser inserido no formato hh:mm:ss, onde hh são horas, mm são minutos e ss são segundos.

Valor mínimo: 00:01:00 (1 minuto)

Valor máximo: 1:00:00 (1 hora)

Padrão: 00:05:00

MaxLogCacheLimit

Opcional

UInt32

Indica o volume de informações máximo (em bytes) que pode ser mantido no cache do arquivo de log antes dele ser limpo e os dados serem gravados em um arquivo de log. Por padrão, os arquivos de log são "liberados" a cada X número de minutos. (para detalhes, consulte a descrição do parâmetro LogFlushInterval). No entanto, se o cache atingir seu tamanho máximo, as informações serão gravadas automaticamente em um arquivo de log (e o cache, limpo) mesmo se o intervalo de liberação do log ainda não tiver expirado.

Padrão: 512000

MaxLogFileSize

Opcional

UInt32

Indica o tamanho máximo, em bytes, para um arquivo de log individual. Quando um arquivo atingir o tamanho máximo, o próximo lote de dados será gravado automaticamente em um arquivo de log. O arquivo de log anterior será mantido até o intervalo de limpeza do log expirar.

Padrão: 1024000

ValidLogFileExtensions

Opcional

PSListModifier

Indica as extensões do arquivo de log válidas que podem ser usadas com o Serviço Web de Atualização de Dispositivos. Essa lista pode ser modificada; no entanto, não há nenhum motivo para modificar a lista, a menos que haja um dispositivo executando o Lync 2010 Phone Edition que crie arquivos de log usando uma extensão de arquivo diferente.

Padrão: .dmp, .clg, .clg2, .bak, .kdmp, .dat, .bin, .cat, .xml, .txt, .hex

ValidLogFileTypes

Opcional

PSListModifier

Indica os tipos de arquivo de log mantidos pelo sistema de atualização do dispositivo. Entre os tipos de arquivo padrão, estão os seguintes:

Watson. Os arquivos de log gerados automaticamente por um dispositivo caso o sistema pare de responder.

Config. Os perfis de Dispositivo de conferência Microsoft RoundTable criados sempre que é feita a configuração de Dispositivo RoundTable.

DiagLog. Dados de autodiagnóstico para o Dispositivo RoundTable.

CELog. Logs para telefones que executam o Lync 2010 que contêm os resultados de testes funcionais e um registro dos eventos críticos de sistema.

Outros tipos de arquivo poderão ser adicionados se você tiver um dispositivo executando o Lync 2010 Phone Edition que crie um tipo de arquivo de log diferente. Também é possível remover arquivos. Por exemplo, se você não quiser armazenar arquivos CELog, será possível remover o tipo de arquivo CELog.

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.

InMemory

Opcional

Parâmetros 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â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

Nenhuma. New-CsDeviceUpdateConfiguration não aceita entrada em pipeline.

Tipos de Retorno

O cmdlet New-CsDeviceUpdateConfiguration cria instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration.

Exemplo

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

New-CsDeviceUpdateConfiguration -Identity site:Redmond

O comando mostrado no Exemplo 1 cria um novo conjunto de definições de configuração de atualização do dispositivo com Identity site:Redmond. Como não há nenhum outro parâmetro incluído no comando, essa nova coleção de definições de configuração usará os valores padrão para cada propriedade.

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

New-CsDeviceUpdateConfiguration -Identity site:Redmond -MaxLogFileSize 204800 -LogCleanUpInterval 7.00:00:00

O comando anterior também cria um novo conjunto de definições de configuração de atualização do dispositivo com Identity site:Redmond. Nesse caso, dois parâmetros adicionais são usados para personalizar as novas configurações: MaxLogFileSize é usado para definir o tamanho do arquivo de log máximo como 2048000 bytes, e LogCleanUpInterval é usado para definir o intervalo de limpeza de logs como 7 dias (7 dias . 00 horas: 00 minutos : 00 segundos).