Compartilhar via


Set-CsDeviceUpdateConfiguration

 

Tópico modificado em: 2012-03-26

Modifica uma coleção de definições de configuração do Serviço Web de Atualização de Dispositivos. 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

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

Set-CsDeviceUpdateConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 Microsoft Lync 2010 Phone Edition esteja em execução. Os administradores carregam periodicamente um conjunto de regras de atualização de dispositivos para o Microsoft 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.

Configurações de atualização de dispositivo podem ser aplicados tanto ao escopo global quando do site. O cmdlet Set-CsDeviceUpdateConfiguration permite que você faça mudanças em uma coleção de configurações. Por exemplo, este cmdlet pode ser usado para mudar a quantidade de tempo pela qual um log de arquivo é guardado antes de ser automaticamente excluído pelo sistema.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Xds Identity

Identificador exclusivo das definições de configuração de atualização de dispositivo a serem modificadas. Para referir-se a configurações globais, use esta sintaxe: -Identity global. Para referir-se a configurações de site, use uma sintaxe semelhante a esta: -Identity "site:Redmond". Note que você não pode usar curingas quando especificando uma Identity.

Instance

Opcional

Objeto DeviceUpdateSettings

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

LogCleanUpInterval

Opcional

Timespan

Especifica a quantidade de tempo que um arquivo de log de atualização de dispositivo é guardado antes que ele seja excluído do 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 entrar somente dias, você deve seguir o valor com um ponto (.).

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 em que o sistema verifica para ver se existem logs expirados que deveriam ser excluídos. (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, em que 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.

LogFlushInterval

Opcional

TimeSpan

Indica com que frequência a informação armazenada na cache do arquivo de log é gravada no arquivo de log atual. 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 tempo de log expirou; ou, 2) a cache atingiu 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 foram registrados, a cache vai ser limpa.

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: 01:00:00 (1 hora).

Padrão: 00:05:00

MaxLogCacheLimit

Opcional

Número inteiro

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

Padrão: 512000

MaxLogFileSize

Opcional

Número inteiro

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 log de arquivo antigo vai ser retido até que o intervalo de remoção de log expire.

Padrão: 1024000

ValidLogFileExtensions

Opcional

PSListModifier

Indica as extensões válidas do arquivo de log que podem ser usadas com o serviço Web de Atualização de Dispositivo. Essa lista pode ser modificada; no entanto, não há nenhum motivo para modificar a lista, a menos que haja um dispositivo compatível com 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 arquivos de log retidos pelo sistema de atualização de dispositivo. Os tipos de arquivo padrão incluem o seguinte:

Watson. Arquivos de log automaticamente gerados por um dispositivo no evento de falha de sistema.

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 Dispositivo RoundTable.

CELog. Logs do Lync 2010 Phone que contenham os resultados de testes funcionais, além de um registro dos eventos críticos de sistema.

Outros tipos de arquivo poderão ser adicionados se você tiver um dispositivo compatível com 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, então você pode remover o tipo de arquivo CELog.

Force

Opcional

Parâmetro de Opção

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

Confirm

Opcional

Parâmetro de Opção

Solicita confirmação antes da 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.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration. Set-CsDeviceUpdateConfiguration aceita instâncias em pipeline do objeto de configuração de atualização de dispositivo.

Tipos de Retorno

Set-CsDeviceUpdateConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration.

Exemplo

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

Set-CsDeviceUpdateConfiguration -Identity global -MaxLogFileSize 2048000 -MaxLogCacheLimit 1024000

O Exemplo 1 mostra como Set-CsDeviceUpdateConfiguration pode ser usado para modificar as configurações globais. Neste caso, dois valores de propriedade são modificados: a propriedade MaxLogFileSize é definida como 2048000 bytes a propriedade MaxLogCacheLimit é definida como 1024000 bytes.

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

Set-CsDeviceUpdateConfiguration -Identity site:Redmond -LogFlushInterval 00:02:00

O comando anterior modifica a propriedade LogFlushInterval para as configurações de atualização de dispositivo com Identity site:Redmond. Para fazer isto, o parâmetro Identity é usado para especificar as configurações no site Redmond e o parâmetro LogFlushInterval é usado para indicar o valor da propriedade a ser alterada. Neste caso, o LogFlushInterval é definido como 2 minutos (00 hours: 02 minutos: 00 segundos).

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

Get-CsDeviceUpdateConfiguration | Set-CsDeviceUpdateConfiguration -LogCleanUpInterval 14.00:00:00

No Exemplo 3, todas as configurações de atualização de dispositivo na organização são modificadas a fim de definir o LogCleanUpInterval para 14 dias. Para fazer isso, Get-CsDeviceUpdateConfiguration é primeiro usado para recuperar uma coleção de todas as configurações de atualização de dispositivo em uso no momento. Esta coleção é então encaminhada para Set-CsDeviceUpdateConfiguration, que usa o parâmetro LogCleanUpInterval para definir o intervalo de tempo de limpeza do log para cada item na coleção para 14 dias (14 dias . 00 horas : 00 minutos : 00 segundos).

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

Get-CsDeviceUpdateConfiguration -Filter "site:*" | Set-CsDeviceUpdateConfiguration -LogCleanUpInterval 20.00:00:00

O Exemplo 4 demonstra como modificar um valor de propriedade para todas as configurações de atualização de dispositivo que foram definidas no escopo do site; neste caso, o comando define o LogCleanUpInterval para 20 dias (20 dias . 00 horas : 00 minutos : 00 segundos). Para fazer isso, o cmdlet Get-CsDeviceUpdateConfiguration é usado com o parâmetro Filter; o valor de filtro "site:*" limita os dados retornados a configurações que tenham Identidade começando com a cadeia de caracteres "site:". Esta coleção filtrada é então direcionada a Set-CsDeviceUpdateConfiguration, que muda o valor do intervalo de limpeza do log para cada item na coleção.

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

Get-CsDeviceUpdateConfiguration | Set-CsDeviceUpdateConfiguration -ValidLogFileTypes @{Remove="CELog"}

O comando anterior remove CELog da lista de tipos de arquivos de log válidos usados pelas configurações de atualização de dispositivos. Neste comando, Get-CsDeviceUpdateConfiguration é primeiro usado para recuperar uma coleção de todas as configurações de atualização de dispositivo atualmente usadas na organização. Esta coleção é então direcionada para Set-CsDeviceUpdateConfiguration, que usa o parâmetro ValidLogFileTypes para remover CELog da lista de tipos de arquivos de log válidos. O valor de parâmetro passado para ValidLogFileTypes, @{Remove=”CELog”}, instrui Set-CsDeviceUpdateConfiguration a remover CELog do conjunto de tipos de arquivo válidos. Para remover múltiplos tipos de arquivo com um único comando, simplesmente inclua os tipos adicionais como parte de uma lista separada por vírgula. Por exemplo:

@{Remove="CELog","Watson"}