Delen via

Remove-SCGuestOSProfile

  • Referentie
Module:
VirtualMachineManager

Hiermee verwijdert u een profielobject voor een gastbesturingssysteem uit VMM.

Syntaxis

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

Description

De Remove-SCGuestOSProfile cmdlet verwijdert een of meer gastbesturingssysteemprofielobjecten uit de VMM-bibliotheek.

Deze cmdlet retourneert het object bij succes (met de eigenschap MarkedForDeletion ingesteld op True) of retourneert een foutbericht bij een fout.

Voorbeelden

Voorbeeld 1: Een specifiek gastbesturingssysteemprofiel uit de bibliotheek verwijderen

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

Met de eerste opdracht wordt het gastbesturingssysteemprofielobject met de naam NewOSProfile01 opgehaald en wordt het object opgeslagen in de $OSProfile variabele.

Met de tweede opdracht wordt het profiel van het gastbesturingssysteem verwijderd dat is opgeslagen in $OSProfile. U wordt gevraagd om bevestiging voordat u de bewerking voltooit.

Voorbeeld 2: Verwijder alle besturingssysteemprofielen zonder te worden gevraagd om elke verwijdering te bevestigen

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

Met de eerste opdracht worden alle profielobjecten van het besturingssysteem opgehaald uit VMMServer01 en worden de objecten opgeslagen in de $OSProfiles objectmatrix.

Met de tweede opdracht wordt elk object in $OSProfiles doorgegeven aan de cmdlet Remove-OSProfile, waarmee elk van de gastbesturingssysteemprofielobjecten uit de VMM-bibliotheek wordt verwijderd.

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-GuestOSProfile

Hiermee geeft u een gastbesturingssysteemprofielobject.

Type:GuestOSProfile
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Notities

  • Hiervoor is een profielobject voor het VMM-gastbesturingssysteem vereist, dat kan worden opgehaald met behulp van de Get-SCGuestOSProfile cmdlet.