Clear-CsDeviceUpdateFile
Letztes Änderungsdatum des Themas: 2012-03-23
Löscht alle abgelehnten Geräteaktualisierungsdateien, die nicht länger einem Gerät zugeordnet sind.
Syntax
Clear-CsDeviceUpdateFile -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Jedes Mal, wenn neue Geräteaktualisierungen in das System hochgeladen werden, wird eine entsprechende Geräteaktualisierungsregel erstellt. Diesen neuen Geräteaktualisierungsregeln wird standardmäßig der Status "Ausstehend" zugewiesen. Dies bedeutet, dass die Regeln auf Testgeräte, nicht jedoch auf Produktionsgeräte heruntergeladen und auf ihnen installiert werden können. Dies bietet Ihnen die Möglichkeit, die Updates zu testen, bevor sie Benutzern zur Verfügung gestellt werden. Wenn der Test erfolgreich ist, können Sie diese Geräteaktualisierungen durch Ausführen des Cmdlets Approve-CsDeviceUpdateRule zur Verfügung stellen.
Wenn der Test nicht erfolgreich ist, können Sie Updates mit den Cmdlets Reset-CsDeviceUpdateRule oder Restore-CsDeviceUpdateRule zurückweisen. Wenn diese Cmdlets ausgeführt werden, wird die Zuordnung zwischen der Geräteaktualisierung selbst und ihrer Geräteaktualisierungsregel aufgehoben. An diesem Punkt können Administratoren dann die Updates, deren Zuordnung aufgehoben wurde, mit Clear-CsDeviceUpdateFile vom Server entfernen.
Dieses Cmdlet kann von folgenden Benutzern ausgeführt werden: Standardmäßig sind Mitglieder der folgenden Gruppen autorisiert, das Cmdlet Clear-CsDeviceUpdateFile lokal auszuführen: RTCUniversalServerAdmins. Geben Sie den folgenden Befehl an der Windows PowerShell-Eingabeaufforderung ein, um eine Liste aller rollenbasierten Zugriffssteuerungsrollen zurückzugeben, die diesem Cmdlet zugewiesen wurden (einschließlich der benutzerdefinierten rollenbasierten Zugriffssteuerungsrollen, die Sie selbst erstellt haben):
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Clear-CsDeviceUpdateFile"}
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Identity |
Erforderlich |
XdsIdentity |
Eindeutige ID des Diensts, der die Geräteaktualisierungsdateien hostet. Mit dieser Syntax werden beispielsweise die Geräteaktualisierungsdateien vom Dienst der Webdienste für den Pool "atl-cs-001.litwareinc.com" gelöscht: -Identity "service:WebServer:atl-cs-001.litwareinc.com". |
Force |
Optional |
Switch-Parameter |
Unterdrückt die Anzeige von Meldungen bei nicht schwerwiegenden Fehlern, die beim Ausführen des Befehls auftreten können. |
WhatIf |
Optional |
Switch-Parameter |
Beschreibt die Auswirkungen einer Ausführung des Befehls, ohne den Befehl tatsächlich auszuführen. |
Confirm |
Optional |
Switch-Parameter |
Fordert Sie vor der Ausführung des Befehls zum Bestätigen auf. |
Eingabetypen
Keine. Clear-CsDeviceUpdateFile akzeptiert keine weitergeleitete Eingabe.
Rückgabetypen
Keine. Clear-CsDeviceUpdateFile gibt keine Werte zurück.
Beispiel
-------------------------- Beispiel 1 ------------------------
Clear-CsDeviceUpdateFile -Identity "service:WebServer:atl-cs-001.litwareinc.com"
Der Befehl in Beispiel 1 löscht alle Geräteaktualisierungsdateien vom Dienst "WebServer:atl-cs-001.litwareinc.com", die nicht länger einem Gerät zugeordnet sind.