Import-CsDeviceUpdate
Tópico modificado em: 2012-03-23
Importa um conjunto de regras de atualização de dispositivos baixadas do site da Microsoft. As regras de atualização de dispositivos associam atualizações de versões de firmware a dispositivos de hardware que estiverem executando o Microsoft Lync 2010 Phone Edition.
Sintaxe
Import-CsDeviceUpdate -Identity <XdsIdentity> -FileName <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Periodicamente, a Microsoft libera um novo conjunto de regras de atualização de dispositivos para o Lync 2010 Phone Edition. Essas regras representam as atualizações de firmware de dispositivos que estiverem executando o Lync 2010 Phone Edition. Depois que essas regras tiverem sido importadas, os administradores poderão testar as atualizações de firmware e, em seguida, presumindo-se que os testes tenham sido bem-sucedidos, poderão disponibilizar as atualizações para todos os dispositivos relevantes usados na organização.
A única maneira de criar novas regras de atualização é fazendo o download de pacotes de atualização da Microsoft. Não é possível criar suas próprias regras de atualização de dispositivos. Para obter o conjunto de regras de atualização de dispositivos mais recente, vá para a página de Ajuda e Suporte no site da Microsoft e procure "Phone Edition". Baixe o pacote de atualização e extraia os arquivos para uma pasta no computador para onde serão carregadas as atualizações. Depois que os arquivos tiverem sido extraídos, utilize o cmdlet Import-CsDeviceUpdate, para importar as regras de atualização de dispositivos encontradas no arquivo .CAB extraído (que terá o nome UCUpdates.cab).
Como observado, as atualizações poderão ser carregadas somente localmente. Será necessário copiar UCUpdates.cab para qualquer computador que execute o serviço Serviços Web que precise hospedar as regras de atualização de dispositivos. Lembre-se também de que as regras de atualização de dispositivos não são replicadas de servidor para servidor. Se você quiser que todas as regras de atualização de dispositivos em toda a organização permaneçam em sincronia, será necessário realizar a mesma operação em cada servidor que hospeda essas regras. Por exemplo, se você remover uma regra de um servidor do Serviços Web, será necessário remover a mesma regra de outros servidores do Serviços Web. Caso contrário, as regras de atualização de dispositivos não estarão mais sincronizadas.
As regras de atualização podem ser importadas apenas para os serviços; elas não se aplicam aos escopos global, do site ou por usuário. No entanto, observe que Import-CsDeviceUpdate não adiciona regras e atualizações automaticamente a cada serviço em um site. Em vez disso, ele carrega essas regras e atualizações apenas no serviço especificado. Por exemplo: se houver três servidores em um site que estiver executando Serviços Web, será necessário executar Import-CsDeviceUpdate três vezes, uma para cada instância do Serviços Web. Como alternativa, é possível usar um comando como o mostrado no Exemplo 3. Esse comando recupera a Identidade de todos os servidores Serviços Web e depois executa Import-CsDeviceUpdate em cada um dos servidores.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Import-CsDeviceUpdate localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Import-CsDeviceUpdate"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
XdsIdentity |
Indica a instância do serviço no qual serão aplicadas as novas regras de atualização. Por exemplo: -Identity "service:WebServer:atl-cs-001.litwareinc.com". |
FileName |
Opcional |
Cadeia de caracteres |
Caminho do arquivo de atualização (por exemplo: C:\Updates\UCUpdates.cab). |
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
Nenhuma. Import-CsDeviceUpdate não aceita a entrada canalizada.
Tipos de Retorno
O cmdlet Import-CsDeviceUpdate importa instâncias da classe Microsoft.Rtc.Management.WritableConfig.Settings.DeviceUpdate.Rule.
Exemplo
-------------------------- Exemplo 1 ------------------------
Import-CsDeviceUpdate -Identity "service:WebServer:atl-cs-001.litwareinc.com" -FileName C:\Updates\UCUpdates.cab
O comando exibido no Exemplo 1 importa regras de atualização de dispositivos do arquivo C:\Updates\UCUpdates.cab.
-------------------------- Exemplo 2 ------------------------
Import-CsDeviceUpdate -Identity "service:WebServer:atl-cs-001.litwareinc.com" -FileName \\atl-fs-001\Updates\UCUpdates.cab
O comando exibido no Exemplo 2 importa regras de atualização de dispositivos do caminho UNC \\atl-fs-001\Updates\UCUpdates.cab.
-------------------------- Exemplo 3 ------------------------
Get-CsService -WebServer | ForEach-Object {Import-CsDeviceUpdate -Identity $_.Identity -FileName C:\Updates\UCUpdates.cab}
O Exemplo 3 mostra como se pode utilizar um único comando para importar regras de atualização de dispositivos para todos os servidores que estiverem executando o Serviços Web. Para fazer isso, o comando chama primeiramente Get-CsService, juntamente com o parâmetro WebServer, para retornar uma coleção de todos os servidores que estiverem executando o serviço do Serviços Web. Essa coleção será então canalizada para o cmdlet ForEach-Object, que irá para cada servidor na coleção e usará Import-CsDeviceUpdate para efetuar a atualização das regras mais recentes dos dispositivos contidos nesses servidores. Observe que esse comando funcionará apenas se você tiver copiado UCUpdates.cab para o mesmo local (C:\Updates) em todos os servidores.