Delen via

Remove-SCGuestOSProfile

  • Referentie
Module:
VirtualMachineManager

Hiermee verwijdert u een profielobject voor een gastbesturingssysteem uit VMM.

Syntax

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

Description

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

Deze cmdlet retourneert het object bij succes (waarbij de eigenschap MarkedForDeletion is ingesteld op Waar) of retourneert een foutbericht bij een fout.

Voorbeelden

Voorbeeld 1: Een specifiek gastbesturingssysteemprofiel verwijderen uit de bibliotheek

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

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

Met de tweede opdracht verwijdert u het gastbesturingssysteemprofiel dat is opgeslagen in $OSProfile, waarbij u wordt gevraagd om bevestiging voordat u de bewerking voltooit.

Voorbeeld 2: Verwijder alle besturingssysteemprofielen zonder dat u wordt 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 besturingssysteemprofielobjecten 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

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Force

Hiermee dwingt u de opdracht uit te voeren zonder om bevestiging van de gebruiker te vragen.

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

-GuestOSProfile

Hiermee geeft u een profielobject voor het gastbesturingssysteem op.

Type:GuestOSProfile
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Notities

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