Clear-CsDeviceUpdateFile
Tópico modificado em: 2012-03-23
Exclui arquivos de atualização de dispositivo rejeitados que não estejam mais associados a um dispositivo.
Sintaxe
Clear-CsDeviceUpdateFile -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Cada vez que novas atualizações de dispositivos são carregadas para o sistema, uma regra de atualização de dispositivo correspondente é criada. Por padrão, essas novas regras de atualização de dispositivos recebem status Pending (pendente), ou seja, podem ser baixadas e instaladas em dispositivos de teste, mas não em dispositivos de produção. Isso oferece a oportunidade de testar as atualizações antes de disponibilizá-las para os usuários. Se o teste for bem-sucedido, use o cmdlet Approve-CsDeviceUpdateRule para disponibilizar essas atualizações de dispositivos para os usuários.
Se o teste fracassar, use o cmdlet Reset-CsDeviceUpdateRule ou o cmdlet Restore-CsDeviceUpdateRule para rejeitar uma atualização. Quando esses cmdlets são executados, a associação da atualização de dispositivo é removida de sua regra de atualização de dispositivo. Nesse momento, os administradores podem usar o cmdlet Clear-CsDeviceUpdateFile para remover as atualizações sem associações do servidor.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Clear-CsDeviceUpdateFile 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 "Clear-CsDeviceUpdateFile"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
Xds Identity |
Identificador único do serviço que hospeda os arquivos de atualização de dispositivos. Por exemplo, esta sintaxe limpa os arquivos de atualização de dispositivos do serviço do Serviços Web para o pool atl-cs-001.litwareinc.com: -Identity "service:WebServer:atl-cs-001.litwareinc.com". |
Force |
Opcional |
Parâmetros 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âmetros de opção |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
Parâmetros de opção |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Nenhuma. Clear-CsDeviceUpdateFile não aceita entrada em pipeline.
Tipos de Retorno
Nenhuma. Clear-CsDeviceUpdateFile não retorna nenhum valor.
Exemplo
-------------------------- Exemplo 1 ------------------------
Clear-CsDeviceUpdateFile -Identity "service:WebServer:atl-cs-001.litwareinc.com"
O comando mostrado no Exemplo 1 exclui todos os arquivos de atualização de dispositivos do serviço WebServer:atl-cs-001.litwareinc.com que não estejam mais associados a um dispositivo.