Compartilhar via


Get-CsDeviceUpdateConfiguration

 

Tópico modificado em: 2012-03-23

Retorna informações sobre as definições de configuração de atualização do dispositivo implantado na organização. Essas definições ajudam a 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 aos telefones e outros dispositivos que estiverem executando o Microsoft Lync 2010 Phone Edition.

Sintaxe

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

Get-CsDeviceUpdateConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

O Serviço Web de Atualização de Dispositivos permite aos administradores distribuir atualizações de firmware a dispositivos que executam o Lync 2010 Phone Edition. Periodicamente, os administradores carregam um conjunto de regras de atualização de dispositivos para o Lync Server 2010. Depois que essas regras tiverem sido testadas e aprovadas, elas podem ser aplicadas aos dispositivos adequados, à medida que estes se conectarem ao sistema. Assim que forem ativados pela primeira vez, os dispositivos procuram atualizações e, em seguida, verificam novamente quando um usuário faz logon. Depois disso, os dispositivos procuram atualizações a cada 24 horas.

O Serviço Web de Atualização de Dispositivos é gerenciado usando-se as definições de configuração de dispositivos, que podem ser aplicadas no escopo global ou de site. É possível usar o cmdlet Get-CsDeviceUpdateConfiguration, para retornar informações sobre as definições de configuração de atualização de dispositivos em uso na organização.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsDeviceUpdateConfiguration localmente: RTCUniversalUserAdmins, 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 "Approve-CsDeviceUpdateRule"}

Parâmetros

Parameter Obrigatório Digite Descrição

Identity

Opcional

Identidade de Xds

Indica a Identidade das definições de configuração de atualização de dispositivos a serem recuperadas. Para se referir às definições globais, utilize essa sintaxe: -Identity global. Para se referir às definições de site, utilize uma sintaxe similar a esta: -Identity site:Redmond. Observe que não é possível utilizar caracteres curinga ao se especificar uma identidade. Se precisar utilizar caracteres curinga, inclua o parâmetro Filter no seu lugar.

Filter

Opcional

Filtro de Identidade Xds

Oferece uma maneira de utilizar caracteres curinga ao se especificar as definições de configuração de atualização de dispositivos. Por exemplo: para retornar uma coleção de todas as definições de configuração aplicadas no escopo de site, use esta sintaxe: -Filter "site:*" Para retornar todas as definições que possuírem o termo "EMEA" em sua Identidade, utilize essa sintaxe: -Filter "*EMEA*". Observe que o parâmetro Filter atua apenas na Identidade das definições. Não é possível filtrar outras propriedades de configuração de atualização de dispositivos.

LocalStore

Opcional

Parâmetro de opção

Recupera os dados de configuração de atualização de dispositivos na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsDeviceUpdateConfiguration não aceita a entrada canalizada.

Tipos de Retorno

Get-CsDeviceUpdateConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration.

Exemplo

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

Get-CsDeviceUpdateConfiguration 

O comando apresentado no Exemplo 1 retorna uma coleção de todas as definições de configuração de atualização de dispositivos em uso na organização. O ato de chamar Get-CsDeviceUpdateConfiguration sem especificar qualquer parâmetro adicional retornará todas as definições de atualização de dispositivos em uso.

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

Get-CsDeviceUpdateConfiguration -Identity Global

No Exemplo 2, retornam-se informações sobre as definições de configuração de atualização de dispositivos.

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

Get-CsDeviceUpdateConfiguration -Filter site:*

O Exemplo 3 mostra o uso do parâmetro Filter. O valor de filtro "site:*" retorna uma coleção de todas as definições de configuração de atualização de dispositivos aplicadas no escopo de site; isso ocorre porque todas essas definições possuem uma Identidade que começa com o valor de cadeia de caracteres "site:".

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

Get-CsDeviceUpdateConfiguration | Where-Object {$_.MaxLogFileSize -gt 2048000}

O comando anterior retorna todas as definições de configuração de atualização de dispositivos cuja propriedade MaxLogFileSize for maior que 2.048.000 bytes. Para fazer isso, utiliza-se Get-CsDeviceUpdateConfiguration, para retornar uma coleção de todas as definições de configuração de atualização de dispositivos em uso. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas as definições cuja propriedade MaxLogFileSize for maior que 2.048.000.

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

Get-CsDeviceUpdateConfiguration | Where-Object {$_.ValidLogFileTypes -like "*Watson*"}

O comando exibido no Exemplo 5 retorna todas as definições de configuração de atualização de dispositivos que incluírem "Watson" como um tipo de arquivo de log válido. Para fazer isso, utiliza-se Get-CsDeviceUpdateConfiguration, para retornar uma coleção de todas as definições de configuração de atualização de dispositivos. Essa coleção será então canalizada para Where-Object, que selecionará apenas as definições de dispositivos que incluírem "Watson" em seu conjunto de tipos válidos de arquivo de log.