Freigeben über

Remove-SCGuestOSProfile

  • Referenz
Modul:
VirtualMachineManager

Entfernt ein Gastbetriebssystemprofilobjekt aus VMM.

Syntax

Remove-SCGuestOSProfile
      [-GuestOSProfile] <GuestOSProfile>
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-SCGuestOSProfile entfernt ein oder mehrere Gastbetriebssystemprofilobjekte aus der VMM-Bibliothek.

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 bestimmten Gastbetriebssystemprofils aus der Bibliothek

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile01"
PS C:\> Remove-SCGuestOSProfile -GuestOSProfile $OSProfile -Confirm

Der erste Befehl ruft das Gastbetriebssystemprofilobjekt namens NewOSProfile01 ab und speichert das Objekt in der $OSProfile Variable.

Der zweite Befehl entfernt das in $OSProfile gespeicherte Gastbetriebssystemprofil, das vor Abschluss des Vorgangs zur Bestätigung aufgefordert wird.

Beispiel 2: Entfernen aller Betriebssystemprofile, ohne aufgefordert zu werden, jede Löschung zu bestätigen

PS C:\> $OSProfiles = Get-SCGuestOSProfile -VMMServer "VMMServer01.Contoso.com"
PS C:\> $OSProfiles | Remove-SCGuestOSProfile

Der erste Befehl ruft alle Betriebssystemprofilobjekte von VMMServer01 ab und speichert die Objekte im $OSProfiles Objektarray.

Der zweite Befehl übergibt jedes Objekt in $OSProfiles an das Cmdlet Remove-OSProfile , das jede der Gastbetriebssystemprofilobjekte aus der VMM-Bibliothek entfernt.

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

-GuestOSProfile

Gibt ein Gastbetriebssystem-Profilobjekt an.

Type:GuestOSProfile
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-Gastbetriebssystemprofilobjekt, das mithilfe des Cmdlets Get-SCGuestOSProfile abgerufen werden kann.