Compartilhar via


Restore-CsDeviceUpdateRule

 

Tópico modificado em: 2012-03-27

Habilita você a "reverter" uma regra de atualização de um dispositivo que tenha sido aprovado para uso na organização. Quando você restaura uma regra de atualização de um dispositivo, a versão aprovada desta regra é redefinida para refletir a atualização que estava em uso antes da regra ser aprovada. Em seguida, dispositivos cliente que conectam ao sistema vão automaticamente desinstalar a atualização mais recente, e então baixar e reinstalar a versão anterior dessa atualização.

Sintaxe

Restore-CsDeviceUpdateRule [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Restore-CsDeviceUpdateRule [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O Microsoft Lync Server 2010 usa regras de atualização de dispositivo como uma forma de fornecer atualizações de firmware para dispositivos que executem o Lync 2010 Phone Edition. Periodicamente, os administradores carregam um conjunto de regras de atualização de dispositivo para o Lync Server 2010; depois que essas regras são testadas e aprovadas, elas são automaticamente baixadas e aplicadas aos dispositivos apropriados na próxima vez em que esses dispositivos se conectarem ao sistema. Por padrão, os dispositivos buscam novas regras de atualização sempre que são ligados e se conectam ao Lync Server; os dispositivos também buscam atualizações a cada 24 horas após a autenticação inicial.

Cada nova regra de atualização de dispositivos adicionada ao sistema é marcada como "Pendente". Isto significa que a atualização vai ser baixada e instalada pelos dispositivos de teste apropriados; no entanto, não vai ser baixada e instalada pelos dispositivos de cliente em geral. Isto dá a você a oportunidade de testar as atualizações e garantir que não há efeitos adversos antes que você disponibilize a atualização amplamente. Assim que estiver convencido de que a atualização passou em seus testes e que vai funcionar em sua organização, use Approve-CsDeviceUpdateRule para aprovar a atualização.

Quando você aprova uma atualização, a PendingVersion da regra de atualização associada é atribuída à ApprovedVersion, e a propriedade PendingVersion é limpa. Por exemplo, suponha que PendingVersion da nova regra de atualização é versão 1.0.0.1. Depois de executar Approve-CsDeviceUpdateRule, PendingVersion será definido com um valor nulo e ApprovedVersion com 1.0.0.1. Na próxima vez em que um dispositivo cliente buscar por uma atualização, ela será baixada e instalada automaticamente.

Além disso, qualquer versão anterior da atualização (por exemplo, versão 1.0.0.0) vai ser marcada como a RestoreVersion. Esta versão da atualização vai permanecer no sistema e vai ser usada se a nova atualização precisar ser revertida. Se começarem a aparecer problemas, os administradores podem usar o cmdlet Restore-CsDeviceUpdateRule para reverter a atualização. Quando isso acontece, na próxima vez em que um dispositivo cliente buscar por atualizações, esse dispositivo irá desinstalar automaticamente a nova atualização (versão 1.0.0.1) e reinstalar a atualização anterior (1.0.0.0).

Observe que isso só acontecerá se existir uma atualização anterior a ser instalada. Se não existir versão anterior, a atualização que está sendo revertida será simplesmente desinstalada.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Cadeia de caracteres

Identificador único para a regra de atualização de dispositivo sendo restaurada. A Identity para uma regra de atualização de dispositivo consiste de duas partes: o serviço no qual a regra de atualização de dispositivo foi atribuída (por exemplo, service:WebServer:atl-cs-001.litwareinc.com) e um GUID (identificador global exclusivo). Consequentemente, uma regra de atualização de dispositivo configurada para o site Redmond terá uma Identity parecida com isso: service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9.

Instance

Opcional

DeviceUpdate.Rule object

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

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.

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.DeviceUpdate.Rule. Restore-CsDeviceUpdateRule aceita instâncias em pipeline do objeto de regra de atualização de dispositivo.

Tipos de Retorno

Nenhuma. Em vez disso, Restore-CsDeviceUpdateRule restaura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.DeviceUpdate.Rule.

Exemplo

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

Restore-CsDeviceUpdateRule -Identity service:WebServer:atl-cs-001.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9

O comando mostrado no Exemplo 1 restaura a regra de atualização de dispositivo d5ce3c10-2588-420a-82ac-dc2d9b1222ff9 encontrada no serviço WebServer:atl-cs-001.litwareinc.com.

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

Get-CsDeviceUpdateRule -Filter service:WebServer:atl-cs-001.litwareinc.com* | Restore-CsDeviceUpdateRule

O comando anterior restaura todas as regras de atualização de dispositivo que foram configuradas para o serviço WebServer:atl-cs-001.litwareinc.com. Para fazer isso, o comando primeiro chama Get-CsDeviceUpdateRule junto com o parâmetro Filter, o valor de filtro "WebServer:atl-cs-001.litwareinc.com*" garante que somente as regras com Identity começando com o valor de cadeia de caracteres "WebServer:atl-cs-001.litwareinc.com" serão retornadas. (Por definição, estas são todas as regras de atualização de dispositivo que foram atribuídas ao serviço WebServer:atl-cs-001.litwareinc.com.) Esta coleção filtrada é então direcionada para o cmdlet Restore-CsDeviceUpdateRule, que restaura cada regra na coleção.

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

Get-CsDeviceUpdateRule | Where-Object {$_.Brand -eq "LG-Nortel"} | Restore-CsDeviceUpdateRule

Exemplo 3 mostra como você pode restaurar todas as regras de atualização de dispositivo para uma marca especificada (LG-Nortel). Para isso, o comando chama inicialmente Get-CsDeviceUpdateRule sem nenhum parâmetro para retornar uma coleção de todas as regras de atualização de dispositivo atualmente em uso na organização. Em seguida, essa coleção é redirecionada para o cmdlet Where-Object, que separa apenas as regras nas quais a propriedade Brand seja igual a LG-Nortel. A coleção filtrada é então direcionada para Restore-CsDeviceUpdateRule, que restaura todas as regras na coleção filtrada.