Udostępnij za pośrednictwem

Remove-SCVirtualDVDDrive

  • Odwołanie
Moduł:
VirtualMachineManager

Usuwa wirtualny obiekt stacji DYSKÓW DVD z programu VMM.

Składnia

Remove-SCVirtualDVDDrive
      [-VirtualDVDDrive] <VirtualDVDDrive>
      [-JobGroup <Guid>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]
Remove-SCVirtualDVDDrive
      -SourceBus <Byte>
      -SourceLUN <Byte>
      -JobGroup <Guid>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [<CommonParameters>]

Opis

Polecenie cmdlet Remove-SCVirtualDVDDrive usuwa co najmniej jeden obiekt wirtualnych dysków DVD z profilu sprzętu, maszyny wirtualnej lub szablonu maszyny wirtualnej używanego w środowisku programu Virtual Machine Manager (VMM). Polecenie cmdlet usuwa również wszystkie pliki .iso używane przez wirtualny dysk DVD z systemu plików na serwerze biblioteki.

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ślonej wirtualnej stacji DYSKÓW DVD z maszyny wirtualnej

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM | where { $_.Bus -eq 1 -and $_.LUN -eq 0 }
PS C:\> Remove-SCVirtualDVDDrive -VirtualDVDDrive $DVDDrive

Pierwsze polecenie pobiera obiekt maszyny wirtualnej o nazwie VM01 i przechowuje obiekt w zmiennej $VM.

Drugie polecenie pobiera wirtualny obiekt stacji dysków DVD znajdujący się w pierwszym miejscu pomocniczego kanału (określonego przez -Bus 1 i -LUN 0) w magistrali IDE na maszynie WIRTUALNEJ VM01, a następnie zapisuje obiekt wirtualnego dysku DVD w zmiennej $DVDDrive.

Ostatnie polecenie usuwa obiekt wirtualnego dysku DVD przechowywanego w $DVDDrive z maszyny VM01 i usuwa wszystkie pliki .iso używane przez ten wirtualny dysk DVD z systemu plików na serwerze biblioteki.

Przykład 2: Usuwanie trzeciej wirtualnej stacji dysków DVD z maszyny wirtualnej

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $DVDDrive = Get-SCVirtualDVDDrive -VM $VM
PS C:\> $DVDDrive[2] | Remove-SCVirtualDVDDrive

Pierwsze polecenie pobiera obiekt maszyny wirtualnej o nazwie VM02 i przechowuje obiekt w zmiennej $VM.

Drugie polecenie pobiera wszystkie obiekty wirtualnego dysku DVD podłączone do maszyny wirtualnej VM02 i przechowuje każdy obiekt wirtualnego dysku DVD w tablicy obiektów $DVDDrive. W tym przykładzie przyjęto założenie, że maszyna WIRTUALNa VM02 ma trzy wirtualne dyski DVD, dlatego tablica zawiera trzy elementy (licząc od 0 do 2).

Ostatnie polecenie przekazuje trzeci wirtualny dysk DVD (obiekt [2]) przechowywany w $DVDDrive do Remove-SCVirtualDVDDrive polecenia cmdlet, który usuwa ten wirtualny obiekt stacji DVD z vm02 i usuwa wszystkie .iso plik używany przez ten wirtualny dysk DVD z systemu plików na serwerze biblioteki.

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

-JobGroup

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

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

-OnBehalfOfUser

Określa nazwę użytkownika. To polecenie cmdlet działa w imieniu użytkownika, który określa ten parametr.

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

-OnBehalfOfUserRole

Określa rolę użytkownika. Aby uzyskać rolę użytkownika, użyj polecenia cmdlet Get-SCUserRole. To polecenie cmdlet działa w imieniu roli użytkownika, którą określa ten parametr.

Typ:UserRole
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

-SourceBus

Określa źródłową magistralę IDE dla dysku.

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

-SourceLUN

Określa źródłowy numer jednostki logicznej (LUN) dla wirtualnego obiektu stacji dysków DVD w magistrali IDE.

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

-VirtualDVDDrive

Określa obiekt wirtualnego dysku DVD.

Typ:VirtualDVDDrive
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
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 wirtualnego dysku DVD programu VMM, który można pobrać przy użyciu polecenia cmdlet Get-SCVirtualDVDDrive.