Sdílet prostřednictvím

Remove-SCGuestOSProfile

  • Reference
Modul:
VirtualMachineManager

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

Syntaxe

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

Description

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

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 vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Vynutí spuštění příkazu bez výzvy k potvrzení uživatele.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-GuestOSProfile

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

Typ:GuestOSProfile
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-JobVariable

Určuje, že průběh úlohy je sledován a uložen v proměnné pojmenované tímto parametrem.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Poznámky

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