Compartilhar via

  • Artigo

Remove-CsDeviceUpdateConfiguration

 

Tópico modificado em: 2012-03-27

Remove as definições de configuração especificadas para a atualização de dispositivos. 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

Remove-CsDeviceUpdateConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O Serviço Web de Atualização de Dispositivos permite aos administradores distribuir atualizações de firmware para 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 Lync Server utiliza as definições de configuração de atualização de dispositivos para gerenciar o Serviço Web de Atualização de Dispositivos; essas definições de configuração podem ser aplicadas no escopo global ou de site. Por padrão, as definições são encontradas apenas no escopo global; entretanto, é possível utilizar o cmdlet New-CsDeviceUpdateConfiguration para atribuir definições personalizadas também no escopo de site.

Além disso, pode se utilizar o cmdlet Remove-CsDeviceUpdateConfiguration para excluir definições que tiverem sido atribuídas no escopo de site. Ao se executar esse cmdlet em um site, serão removidas as definições de configuração de atualização de dispositivos atribuídas a esse site. Remove-CsDeviceUpdateConfiguration também pode ser executado nas definições globais. Neste caso, entretanto, as definições globais não serão removidas porque não é possível remover as definições globais de configuração de atualização de dispositivos. Em vez disso, as propriedades globais serão redefinidas com os seus valores padrão. Por exemplo, suponha que a propriedade global MaxLogCacheLimit tenha sido alterada para 1.024.000 bytes. Se Remove-CsDeviceUpdateConfiguration for executado nas definições globais, estas não serão removidas. Entretanto, quaisquer propriedades que tiverem sido modificadas serão redefinidas com os seus valores padrão. Isto significa que MaxLogCacheLimit será redefinido como 512.000 bytes.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Identidade de Xds

Indica a identidade das definições de configuração de atualização de dispositivos a serem removidas. Para fazer referência às definições globais, utilize esta 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.

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.Settings.DeviceUpdate.DeviceUpdateConfiguration. Remove-CsDeviceUpdateConfiguration aceita instâncias canalizadas do objeto de configuração de atualização de dispositivos.

Tipos de Retorno

Nenhuma. Em vez disso, o cmdlet Remove-CsDeviceUpdateConfiguration exclui instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdateConfiguration.

Exemplo

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

Remove-CsDeviceUpdateConfiguration -Identity global

No Exemplo 1, Remove-CsDeviceUpdateConfiguration é utilizado para "remover" as definições globais de configuração de atualização de dispositivos. Como as definições globais não podem realmente ser removidas, o comando não excluirá nada. Entretanto, todas as propriedades das definições globais de configuração de atualização de dispositivos serão redefinidas com os seus valores padrão. W

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

Remove-CsDeviceUpdateConfiguration -Identity site:Redmond

Os comandos anteriores removem as definições de configuração de atualização de dispositivos cuja identidade for site:Redmond. Como essas definições foram configuradas no escopo de site, elas serão excluídas e o site Redmond não terá mais seu próprio conjunto de definições de configuração de atualização de dispositivos.

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

Get-CsDeviceUpdateConfiguration -Filter "site:*" | Remove-CsDeviceUpdateConfiguration

No Exemplo 3, todas as definições de configuração de atualização de dispositivos que tiverem sido configuradas no escopo de site serão excluídas. Para isso, utilizam-se o cmdlet Get-CsDeviceUpdateConfiguration e o parâmetro-Filter, para retornar todas as definições cuja identidade começar com o valor da cadeia de caracteres "site:". Por definição, serão todas as definições que tiverem sido configuradas no escopo de site. Esta coleção será então canalizada para o cmdlet Remove-CsDeviceUpdateConfiguration, que, por sua vez, removerá cada um dos itens na coleção.

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

Get-CsDeviceUpdateConfiguration | Where-Object {$_.MaxLogFileSize -lt 1024000} | Remove-CsDeviceUpdateConfiguration

No Exemplo 4, serão excluídas todas as definições de configuração de atualização de dispositivos cuja propriedade MaxLogFileSize for maior do que 1.024.000 bytes. Para realizar essa tarefa, chama-se primeiramente Get-CsDeviceUpdateConfiguration, para retornar uma coleção de todas as definições de configuração de atualização de dispositivos. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas as definições de configuração cuja propriedade MaxLogFileSize for maior do que 1.024.000 bytes. A coleção filtrada será então canalizada para Remove-CsDeviceUpdateConfiguration, que excluirá cada item na coleção.