Sdílet prostřednictvím

Remove-SCGuestOSProfile

  • Reference
Modul:
VirtualMachineManager

Odebere objekt profilu hostovaného operačního systému z nástroje VMM.

Syntax

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

Description

Rutina Remove-SCGuestOSProfile odebere z knihovny VMM jeden nebo více objektů profilu hostovaného operačního systému.

Tato rutina vrátí objekt po úspěchu (s vlastností MarkedForDeletion nastavenou na Hodnotu True) nebo vrátí chybovou zprávu při selhání.

Příklady

Příklad 1: Odebrání konkrétního profilu hostovaného operačního systému z knihovny

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

První příkaz získá objekt profilu hostovaného operačního systému s názvem NewOSProfile01 a uloží objekt do proměnné $OSProfile.

Druhý příkaz odebere profil hostovaného operačního systému uložený v $OSProfile a před dokončením operace zobrazí výzvu k potvrzení.

Příklad 2: Odebrání všech profilů operačního systému bez výzvy k potvrzení každého odstranění

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

První příkaz získá všechny objekty profilu operačního systému z VMMServer01 a uloží objekty do pole objektů $OSProfiles.

Druhý příkaz předá každý objekt v $OSProfiles rutině Remove-OSProfile , která odebere všechny objekty profilu hostovaného operačního systému z knihovny VMM.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Force

Vynutí spuštění příkazu bez žádosti o potvrzení uživatele.

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

-GuestOSProfile

Určuje objekt profilu hostovaného operačního systému.

Type:GuestOSProfile
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-JobVariable

Určuje, že průběh úlohy se sleduje a ukládá do proměnné pojmenované tímto parametrem.

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

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.

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

-RunAsynchronously

Označuje, že úloha běží asynchronně, aby se ovládací prvek vrátil do příkazového prostředí okamžitě.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Poznámky

  • Vyžaduje objekt profilu hostovaného operačního systému VMM, který lze načíst pomocí rutiny Get-SCGuestOSProfile .