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.
Consulte Também
Outros Recursos
Approve-CsDeviceUpdateRule
Get-CsDeviceUpdateRule
Remove-CsDeviceUpdateRule
Reset-CsDeviceUpdateRule