Compartilhar via

  • Artigo

Reset-CsDeviceUpdateRule

 

Tópico modificado em: 2012-03-25

Rejeita uma regra de atualização de dispositivo importada para o sistema.

Sintaxe

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

Reset-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. Os administradores carregam periodicamente um conjunto de regras de atualização de dispositivos para o Lync Server 2010. Depois de testadas e aprovadas, essas regras são baixadas e aplicadas automaticamente aos dispositivos apropriados assim que eles são conectados 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, depois da autenticação inicial.

Cada nova regra de atualização de dispositivo adicionada ao sistema é marcada como "Pendente". Isso significa que a atualização será baixada e instalada pelos dispositivos de teste apropriados. No entanto, ela não será baixada e instalada por dispositivos cliente em geral. Isso dá a você uma oportunidade de testar as atualizações e verificar se não há nenhum efeito negativo antes de tornar essa atualização amplamente disponível. 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.

Por outro lado, os administradores podem concluir que uma determinada atualização não deve ser usada na organização (por exemplo, a atualização pode causar um conflito com o software interno). Nesse caso, os administradores podem usar o cmdlet Reset-CsDeviceUpdateRule para rejeitar a atualização. Quando isso acontece, PendingVersion da regra de atualização é definida como um valor nulo. Por sua vez, isso significa que os dispositivos de teste que fazem logon no sistema irão desinstalar a atualização e reinstalar a versão aprovada dessa atualização. E como a atualização jamais foi aprovada, isso significa que a ela jamais será instalada por outros dispositivos senão os de teste. Isso significa que não haverá nenhum impacto sobre a população de usuários em geral.

O cmdlet Reset-CsDeviceUpdateRule só pode ser usado para regras de atualização de dispositivo no estado Pendente. Se uma regra já tiver sido aprovada, você precisará usar o cmdlet Restore-CsDeviceUpdateRule para reverter a implantação da atualização de dispositivo.

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Cadeia de caracteres

O identificador exclusivo da regra de atualização de dispositivo sendo redefinida. A Identity de uma regra de atualização consiste em 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 para o site de Redmond terá uma Identidade semelhante a esta: "service:WebServer:atl-cs-oo1.litwareinc.com/d5ce3c10-2588-420a-82ac-dc2d9b1222ff9".

Instance

Opcional

DeviceUpdate.Rule

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

Force

Opcional

Parâmetros de opção

Suprime os prompts de confirmação ou mensagens de erro não fatal que podem ocorrer quando você executa o cmdlet.

WhatIf

Opcional

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

Tipos de Retorno

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

Exemplo

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

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

O comando mostrado no Exemplo 1 redefine 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*  | Reset-CsDeviceUpdateRule

O comando anterior redefine todas as regras de atualização de dispositivo configuradas para o serviço WebServer:atl-cs-001.litwareinc.com. Isso é feito chamando-se primeiramente Get-CsDeviceUpdateRule com o parâmetro Filter; o valor de filtro "WebServer:atl-cs-001.litwareinc.com*" garante que apenas regras que tenham propriedade Identity começando com os caracteres "WebServer:atl-cs-001.litwareinc.com" sejam retornadas. (Por definição, elas são todas as regras de atualização de dispositivo atribuídas ao serviço WebServer:atl-cs-001.litwareinc.com.) Em seguida, a coleção filtrada é redirecionada para o cmdlet Reset-CsDeviceUpdateRule, que redefine todas as regras da coleção.

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

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

O comando mostrado no Exemplo 3 redefine todas as regras de atualização de dispositivo da marca 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. Depois disso, essa coleção filtrada é redirecionada para Reset-CsDeviceUpdateRule, que redefine todas as regras na coleção filtrada.