Clear-CsDeviceUpdateFile
Última modificación del tema: 2012-03-23
Elimina todos los archivos de actualización de dispositivos rechazados que ya no están asociados con un dispositivo.
Sintaxis
Clear-CsDeviceUpdateFile -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Cada vez que se carga una nueva actualización de dispositivo en el sistema, se crea la regla de actualización de dispositivos correspondiente. En forma predeterminada, estas nuevas reglas de actualización de dispositivo se asignan al estado pendiente; eso significa que las reglas pueden descargarse e instalarse en dispositivos de prueba, pero no en dispositivos de producción. A su vez, esto le da una oportunidad para probar las actualizaciones antes de ponerlas a disponibilidad de los usuarios. Si la prueba se realiza correctamente, puede ejecutar el cmdlet Approve-CsDeviceUpdateRule para poner estas actualizaciones de dispositivos a disponibilidad de los usuarios.
Si la prueba no se realiza correctamente, entonces puede usar el cmdlet Reset-CsDeviceUpdateRule o de Restore-CsDeviceUpdateRule para rechazar una actualización. Cuando se ejecutan estos cmdlets, la actualización de dispositivos se desasocia de su regla de actualización de dispositivos. En ese momento, los administradores pueden usar el cmdlet Clear-CsDeviceUpdateFile para quitar las actualizaciones desasociadas del servidor.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Clear-CsDeviceUpdateFile localmente: RTCUniversalServerAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Clear-CsDeviceUpdateFile"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Identificador único del servicio que hospeda los archivos de actualización de dispositivo. Por ejemplo, esta sintaxis elimina los archivos de actualización de dispositivo del servicio Servicios web para el grupo atl-cs-001.litwareinc.com: -Identity "service:WebServer:atl-cs-001.litwareinc.com". |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no sean graves y que puedan producirse al ejecutar el comando. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Ninguno. Clear-CsDeviceUpdateFile no acepta entradas canalizadas.
Tipos de valores devueltos
Ninguno. Clear-CsDeviceUpdateFile no devuelve ningún valor.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Clear-CsDeviceUpdateFile -Identity "service:WebServer:atl-cs-001.litwareinc.com"
El comando que se muestra en el Ejemplo 1 elimina todos los archivos de actualización de dispositivos del servicio WebServer:atl-cs-001.litwareinc.com que ya no estén asociados con un dispositivo.