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 wenn 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 "Ja" beantworten, entfernt VMM die Zuordnung zwischen der ISO und dem Container, dem sie angefügt ist, und löscht das ISO-Objekt dann aus VMM.

  • Wenn Sie antworten Nein, wird der Vorgang abgebrochen.

Dieses Cmdlet gibt das Objekt nach Erfolg zurück (mit der Eigenschaft MarkedForDeletion auf $True festgelegt) oder eine Fehlermeldung beim Fehler zurück.

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.

Mit dem zweiten Befehl wird das ISO-Objekt aus der Bibliothek entfernt und die entsprechende ISO-Datei aus dem Dateisystem auf dem Bibliothekserver gelöscht.

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 diese ISO-Objekte in der $ISOs Variablen speichert.

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

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ISO

Gibt ein ISO-Objekt an.

Type:ISO
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Hinweise

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