Compartilhar via


Approve-CsDeviceUpdateRule

 

Tópico modificado em: 2012-03-23

Aprova uma regra de atualização de dispositivo que foi importada para o sistema. Depois que uma regra de atualização de dispositivo tiver sido aprovada, a atualização correspondente será baixada automaticamente e instalada pelos dispositivos clientes afetados pela atualização.

Sintaxe

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

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

Descrição Detalhada

O Microsoft Lync Server 2010 usa regras de atualização de dispositivos como uma maneira de fornecer atualizações de firmware para dispositivos que executam Lync 2010 Phone Edition. Periodicamente, os administradores carregam para o Lync Server 2010 um conjunto de regras de atualização de dispositivos. Depois que essas regras tiverem sido testadas e aprovadas, elas serão automaticamente baixadas e aplicadas aos dispositivos relevantes, à medida que eles se conectarem ao sistema. Por padrão, os dispositivos verificam se há novas regras de atualização, sempre que forem ligados e se conectarem ao Lync Server 2010. Os dispositivos também verificam se há atualizações a cada 24 horas após o registro 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 relevantes; no entanto, ela não será baixada nem instalada pelos dispositivos clientes em geral. Isso proporciona uma oportunidade de se testar as atualizações e garantir que não haja efeitos negativos antes de implantar essa atualização globalmente. Quando estiver certo de que a atualização passou nos testes e funcionará na organização, utilize Approve-CsDeviceUpdateRule para aprovar a atualização.

Quando a atualização for aprovada, PendingVersion da regra de atualização associada será atribuído a ApprovedVersion, e a propriedade PendingVersion será limpa. Por exemplo, suponhamos que PendingVersion de uma nova regra de atualização seja a versão 1.0.0.1. Depois que Approve-CsDeviceUpdateRule for executado, PendingVersion será definida com um valor nulo e ApprovedVersion será definida como 1.0.0.1. Na próxima vez em que um dispositivo cliente fizer logon, o dispositivo verificará automaticamente se há atualizações aprovadas recentemente aplicáveis ao dispositivo. Se houver, a atualização será baixada e instalada automaticamente.

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

Cadeia de caracteres

Identificador exclusivo da regra de atualização do dispositivo que estiver sendo aprovada. A identidade de uma regra de atualização de dispositivo consiste em duas partes: o serviço no qual foi atribuída a regra de atualização do dispositivo (por exemplo: service:WebServer:atl-cs-001.litwareinc.com) e um identificador globalmente exclusivo (GUID). Consequentemente, uma regra de atualização de dispositivo configurada para o site de Redmond terá uma Identidade semelhante a essa: service:WebServer:atl-cs-001.litwareinc.com /d5ce3c10-2588-420a-82ac-dc2d9b1222ff9.

Instance

Opcional

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

Tipos de Retorno

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

Exemplo

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

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

O comando exibido no Exemplo 1 aprova 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* | Approve-CsDeviceUpdateRule

O comando anterior aprova todas as regras de atualização de dispositivo que tiverem sido configuradas para o serviço WebServer:atl-cs-001.litwareinc.com. Para fazer isso, o comando primeiramente chama Get-CsDeviceUpdateRule, juntamente com o parâmetro Filter. O valor de filtro "service:WebServer:atl-cs-001.litwareinc.com*" garante que serão retornadas somente as regras cuja Identidade começar pelo valor de cadeia de caracteres "service:WebServer:atl-cs-001.litwareinc.com". (por definição, essas são todas as regras de atualização de dispositivo que tiverem sido atribuídas ao serviço WebServer:atl-cs-001.litwareinc.com.) Esta coleção filtrada será então canalizada para o cmdlet Approve-CsDeviceUpdateRule, que aprovará cada regra nessa coleção.

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

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

O comando exibido no Exemplo 3 aprova todas as regras de atualização de dispositivos da marca especificada (LG-Nortel). Para fazer isso, o comando chama primeiramente Get-CsDeviceUpdateRule, para retornar uma coleção de todas as regras de atualização de dispositivos em uso na organização. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas as regras cuja propriedade Brand for igual a LG-Nortel. A coleção filtrada será então canalizada para Approve-CsDeviceUpdateRule, que aprovará cada regra nessa coleção.