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 Virtual Machine Manager -Bibliothek (VMM) 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 Force-Parameter 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 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 (mit der Eigenschaft "MarkedForDeletion" auf $True festgelegt) zurück oder gibt eine Fehlermeldung 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 der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die 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, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

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.