Udostępnij za pośrednictwem

Remove-SCGuestOSProfile

  • Odwołanie
Moduł:
VirtualMachineManager

Usuwa obiekt profilu systemu operacyjnego gościa z programu VMM.

Składnia

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

Opis

Polecenie cmdlet Remove-SCGuestOSProfile usuwa co najmniej jeden obiekt profilu systemu operacyjnego gościa z biblioteki programu VMM.

To polecenie cmdlet zwraca obiekt po powodzeniu (z właściwością MarkedForDeletion ustawioną na true) lub zwraca komunikat o błędzie po awarii.

Przykłady

Przykład 1. Usuwanie określonego profilu systemu operacyjnego gościa z biblioteki

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

Pierwsze polecenie pobiera obiekt profilu systemu operacyjnego gościa o nazwie NewOSProfile01 i przechowuje obiekt w zmiennej $OSProfile.

Drugie polecenie usuwa profil systemu operacyjnego gościa przechowywany w $OSProfile, wyświetlając monit o potwierdzenie przed ukończeniem operacji.

Przykład 2. Usuwanie wszystkich profilów systemu operacyjnego bez monitowania o potwierdzenie każdego usunięcia

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

Pierwsze polecenie pobiera wszystkie obiekty profilu systemu operacyjnego z serwera VMMServer01 i przechowuje obiekty w tablicy obiektów $OSProfiles.

Drugie polecenie przekazuje każdy obiekt w $OSProfiles do polecenia cmdlet Remove-OSProfile , które usuwa każdy z obiektów profilu systemu operacyjnego gościa z biblioteki programu VMM.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

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

-GuestOSProfile

Określa obiekt profilu systemu operacyjnego gościa.

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

-JobVariable

Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie przez ten parametr.

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

-PROTipID

Określa identyfikator porady wydajności i optymalizacji zasobów (porada PRO), która wyzwoliła tę akcję. Ten parametr umożliwia inspekcję porad PRO.

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

-RunAsynchronously

Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Uwagi

  • Wymaga obiektu profilu systemu operacyjnego gościa programu VMM, który można pobrać za pomocą polecenia cmdlet Get-SCGuestOSProfile .