Remove-SCVMTemplate
Usuwa obiekt szablonu z programu VMM.
Składnia
Default (Domyślna)
Remove-SCVMTemplate
[-VMTemplate] <Template>
[-Force]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Remove-SCVMTemplate usuwa obiekt szablonu z biblioteki programu Virtual Machine Manager (VMM). Usunięcie obiektu szablonu nie powoduje usunięcia żadnych wirtualnych dysków twardych skojarzonych z szablonem.
Typy plików, które można skojarzyć z szablonem, obejmują pliki wirtualnego dysku twardego (pliki vhd oparte na systemie Windows, pliki vhd oparte na Citrix XenServer lub pliki vmdk oparte na oprogramowaniu VMware), pliki dyskietek wirtualnych (pliki vfd oparte na systemie Windows lub pliki flp oparte na oprogramowaniu VMware) oraz pliki skryptów (pliki skryptów programu Windows PowerShell .ps1 lub skrypty plików odpowiedzi, w tym pliki Sysprep.inf i pliki Unattend.xml).
To polecenie cmdlet zwraca obiekt w przypadku powodzenia (z właściwością MarkedForDeletion ustawioną na wartość TRUE) lub zwraca komunikat o błędzie w przypadku niepowodzenia.
Przykłady
Przykład 1: Usuwanie określonego szablonu z biblioteki
PS C:\> $Template = Get-SCVMTemplate -VMMServer "VMMServer1.Contoso.com" | where { $_.Name -eq "Template01" }
PS C:\> Remove-SCVMTemplate -VMTemplate $Template
Pierwsze polecenie pobiera obiekt szablonu o nazwie Template01 z biblioteki w programie VMMServer01 i zapisuje obiekt w zmiennej $Template.
Drugie polecenie usuwa z biblioteki obiekt szablonu przechowywany w $Template.
Przykład 2: Usuwanie wszystkich szablonów z biblioteki
PS C:\> $Templates = Get-SCVMTemplate -VMMServer "VMMServer01.Contoso.com"
PS C:\> $Templates | Remove-SCVMTemplate -Confirm
Pierwsze polecenie pobiera wszystkie obiekty szablonu z programu VMMServer01 i zapisuje je w tablicy o nazwie $Templates.
Drugie polecenie przekazuje każdy obiekt szablonu w $Templates do polecenia cmdlet Remove-SCVMTemplate , które usuwa każdy obiekt szablonu z biblioteki programu VMM. Parametr Confirm monituje o potwierdzenie, czy chcesz usunąć każdy szablon.
Parametry
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Force
Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-JobVariable
Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie tego parametru.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | 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.
Właściwości parametru
| Typ: | Guid |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-RunAsynchronously
Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-VMTemplate
Określa obiekt szablonu programu VMM używany do tworzenia maszyn wirtualnych.
Właściwości parametru
| Typ: | Template |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Szablon |
Zestawy parametrów
(All)
| Position: | 0 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wyjściowe
SCVMTemplate
To polecenie cmdlet zwraca obiekt SCVMTemplate .
Uwagi
- Wymaga obiektu szablonu programu VMM, który można pobrać przy użyciu polecenia cmdlet Get-SCVMTemplate .