Freigeben über

Remove-SCISO

  • Referenz
Modul:
VirtualMachineManager

Entfernt eine ISO-Datei aus der VMM-Bibliothek.

Syntax

Remove-SCISO
      [-ISO] <ISO>
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das cmdlet Remove-SCISO entfernt eine ISO-Datei aus der VMM-Bibliothek (Virtual Machine Manager) und löscht die ISO-Datei auf dem Bibliotheksserver.

Wenn die ISO an einen virtuellen Computer, eine Vorlage oder ein Hardwareprofil angefügt ist und Sie den Parameter Force nicht angeben, listet VMM den Container auf, der die ISO enthält, und fordert Sie auf, zu bestätigen, dass Sie die ISO entfernen möchten:

  • Wenn Sie auf "Ja" antworten, entfernt VMM die Zuordnung zwischen der ISO und dem Container, dem sie angefügt ist, und löscht dann das ISO-Objekt aus VMM.

  • Wenn Sie "Nein" antworten, wird der Vorgang abgebrochen.

Dieses Cmdlet gibt das Objekt nach Erfolg zurück (wobei die Eigenschaft "MarkedForDeletion" auf $True festgelegt ist) oder bei Einem Fehler eine Fehlermeldung zurückgibt.

Beispiele

Beispiel 1: Entfernen eines ISO-Objekts und Löschen der entsprechenden .iso Datei

PS C:\> $ISO = Get-SCISO -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "OsISO.iso" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Remove-SCISO -ISO $ISO

Der erste Befehl ruft das ISO-Objekt namens OsISO.iso aus LibraryServer01 ab und speichert das ISO-Objekt in der $ISO Variablen.

Der zweite Befehl entfernt das ISO-Objekt aus der Bibliothek und löscht die entsprechende .iso Datei aus dem Dateisystem auf dem Bibliotheksserver.

Beispiel 2: Entfernen mehrerer ISO-Objekte aus der Bibliothek

PS C:\> $ISOs = Get-SCISO -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "OsISO" }
PS C:\> $ISOs | Remove-SCISO

Der erste Befehl ruft alle ISO-Objekte ab, deren Name die Zeichenfolge "OsISO" enthält, und speichert diese ISO-Objekte in der $ISOs Variablen.

Der zweite Befehl übergibt jedes ISO-Objekt in $ISOs an das Cmdlet Remove-SCISO, das jedes ISO-Objekt aus der Bibliothek entfernt und die entsprechende .iso Datei aus dem Dateisystem auf dem Bibliotheksserver löscht.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ISO

Gibt ein ISO-Objekt an.

Typ:ISO
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Hinweise

  • Erfordert ein VMM ISO-Objekt, das mithilfe des cmdlets Get-SCISO abgerufen werden kann.