Udostępnij za pośrednictwem

Remove-SCVMTemplate

  • Odwołanie
Moduł:
VirtualMachineManager

Usuwa obiekt szablonu z programu VMM.

Składnia

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 mogą być skojarzone z szablonem, obejmują pliki wirtualnego dysku twardego (pliki vhd oparte na systemie Windows, pliki vhd oparte na programie Citrix XenServer lub pliki VMware oparte na pliku vmdk), pliki wirtualne dyskietki (pliki vfd oparte na systemie Windows lub pliki flp oparte na oprogramowaniu VMware) i pliki skryptów (Windows PowerShell .ps1 pliki skryptów lub pliki plików odpowiedzi, w tym sysprep.inf i pliki Unattend.xml).

To polecenie cmdlet zwraca obiekt po powodzeniu (z właściwością MarkedForDeletion ustawioną na WARTOŚĆ TRUE) lub zwraca komunikat o błędzie po niepowodzeniu.

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 na serwerze VMMServer01 i przechowuje obiekt w zmiennej $Template.

Drugie polecenie usuwa obiekt szablonu przechowywany w $Template z biblioteki.

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 serwera VMMServer01 i przechowuje obiekty 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

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

-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

-VMTemplate

Określa obiekt szablonu programu VMM używany do tworzenia maszyn wirtualnych.

Type:Template
Aliases:Template
Position:0
Default value:None
Required:True
Accept pipeline input:True
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

Dane wyjściowe

SCVMTemplate

To polecenie cmdlet zwraca obiekt SCVMTemplate .

Uwagi

  • Wymaga obiektu szablonu programu VMM, który można pobrać za pomocą polecenia cmdlet Get-SCVMTemplate .