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, monitując 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, co powoduje usunięcie każdego obiektu profilu systemu operacyjnego gościa z biblioteki programu VMM.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-GuestOSProfile

Określa obiekt profilu systemu operacyjnego gościa.

Typ:GuestOSProfile
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-JobVariable

Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie tego parametru.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Uwagi

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