Remove-SCGuestOSProfile
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 -ConfirmDer 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-SCGuestOSProfileDer 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.