Udostępnij przez


Remove-SCVirtualHardDisk

Usuwa obiekt wirtualnego dysku twardego z maszyny wirtualnej lub szablonu albo z biblioteki programu VMM.

Składnia

Default (Domyślna)

Remove-SCVirtualHardDisk
    [-VirtualHardDisk] <VirtualHardDisk>
    [-JobGroup <Guid>]
    [-Force]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Polecenie cmdlet Remove-SCVirtualHardDisk usuwa obiekt wirtualnego dysku twardego z maszyny wirtualnej lub szablonu albo z biblioteki programu Virtual Machine Manager (VMM). Remove-VirtualHardDisk usuwa również odpowiedni plik wirtualnego dysku twardego (plik .vhd oparty na systemie Windows, plik .vhd oparty na Citrix XenServer lub plik .vmdk oparty na oprogramowaniu VMware) z serwera biblioteki.

Jeśli wirtualny dysk twardy jest dołączony do dysku wirtualnego na maszynie wirtualnej lub szablonie (i jeśli parametr Force nie jest używany), program VMM wyświetli listę kontenera zawierającego wirtualny dysk twardy i wyświetli monit o potwierdzenie, że chcesz usunąć wirtualny dysk twardy:

  • Jeśli odpowiesz Tak, program VMM usunie skojarzenie między wirtualnym dyskiem twardym a kontenerem, do którego jest dołączony, a następnie usunie obiekt wirtualnego dysku twardego z programu VMM.

  • Jeśli odpowiesz Nie, operacja zostanie anulowana.

To polecenie cmdlet zwraca obiekt po pomyślnym zakończeniu (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 obiektu wirtualnego dysku twardego z biblioteki

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "VHD01.vhd" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Remove-SCVirtualHardDisk -VirtualHardDisk $VHD

Pierwsze polecenie pobiera obiekt wirtualnego dysku twardego o nazwie VHD01.vhd przechowywany na serwerze LibraryServer01 i zapisuje zwrócony obiekt w zmiennej $VHD.

Drugie polecenie usuwa z biblioteki obiekt wirtualnego dysku twardego przechowywany w $VHD i usuwa odpowiadający mu plik z systemu plików na serwerze biblioteki.

Przykład 2: Usuwanie wirtualnego dysku twardego z maszyny wirtualnej

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VHD = Get-SCVirtualMachine -Name "VM01" | Get-SCVirtualHardDisk | where { $_.Name -match "DataDisk" }
PS C:\> $VHD | Remove-SCVirtualHardDisk

Pierwsze polecenie łączy się z programem VMMServer01.

Drugie polecenie pobiera obiekt maszyny wirtualnej o nazwie VM01, pobiera wszystkie wirtualne dyski twarde na maszynie VM01, których nazwa zawiera ciąg "DataDisk", a następnie zapisuje te obiekty wirtualnego dysku twardego w tablicy o nazwie $VHD.

Trzecie polecenie usuwa każdy obiekt wirtualnego dysku twardego przechowywany w tablicy $VHD z maszyny wirtualnej i usuwa każdy odpowiadający mu plik z systemu plików na serwerze biblioteki.

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

-JobGroup

Określa identyfikator serii poleceń, które będą uruchamiane jako zestaw tuż przed ostatnim poleceniem zawierającym ten sam identyfikator grupy zadań.

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

-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

-VirtualHardDisk

Określa obiekt wirtualnego dysku twardego.

Właściwości parametru

Typ:VirtualHardDisk
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

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.

Uwagi

  • Wymaga obiektu wirtualnego dysku twardego programu VMM, który można pobrać przy użyciu polecenia cmdlet Get-SCVirtualHardDisk .