Udostępnij za pośrednictwem

Set-SCVirtualDVDDrive

  • Odwołanie
Moduł:
VirtualMachineManager

Zmienia właściwości wirtualnego dysku DVD skojarzonego z maszyną wirtualną, szablonem maszyny wirtualnej lub profilem sprzętowym używanym w programie VMM.

Składnia

Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-VirtualDVDDrive] <VirtualDVDDrive>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-NoMedia]
   -JobGroup <Guid>
   -SourceBus <Byte>
   -SourceLUN <Byte>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-VirtualDVDDrive] <VirtualDVDDrive>
   -VMHostDrive <String>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-VirtualDVDDrive] <VirtualDVDDrive>
   [-NoMedia]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-VirtualDVDDrive] <VirtualDVDDrive>
   [-JobGroup <Guid>]
   [-AnyVMHostDrive]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-Link]
   -ISO <ISO>
   -JobGroup <Guid>
   -SourceBus <Byte>
   -SourceLUN <Byte>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   -VMHostDrive <String>
   -JobGroup <Guid>
   -SourceBus <Byte>
   -SourceLUN <Byte>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   [-Link]
   [-VirtualDVDDrive] <VirtualDVDDrive>
   -ISO <ISO>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   -JobGroup <Guid>
   [-AnyVMHostDrive]
   -SourceBus <Byte>
   -SourceLUN <Byte>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVirtualDVDDrive
   [-Bus <Byte>]
   [-LUN <Byte>]
   -JobGroup <Guid>
   -SourceBus <Byte>
   -SourceLUN <Byte>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Set-SCVirtualDVDDrive zmienia co najmniej jedną właściwość obiektu wirtualnego dysku DVD skojarzonego z maszyną wirtualną, szablonem maszyny wirtualnej lub profilem sprzętu używanym w środowisku programu Virtual Machine Manager (VMM).

To polecenie cmdlet służy do łączenia wirtualnego dysku DVD z fizyczną stacją DYSKÓW DVD na serwerze hosta maszyny wirtualnej, z inną lokalizacją w magistrali IDE lub obrazem ISO lub za pomocą niego można odłączyć wirtualny dysk DVD.

Większość ustawień, które można skonfigurować dla wirtualnego dysku DVD na maszynie wirtualnej, jest taka sama, niezależnie od tego, czy platforma wirtualizacji hosta to Hyper-V, VMware lub Citrix XenServer. Wszystkie te platformy wirtualizacji obsługują następujące elementy:

  • Podłączanie wirtualnego dysku DVD do podstawowego lub pomocniczego kanału na hoście.

  • Przechwytywanie informacji z fizycznego dysku CD lub DVD na hoście bez określania litery dysku.

  • Przechwytywanie informacji z pliku obrazu (ISO) przechowywanego w bibliotece programu VMM.

  • Przechwytywanie "braku nośnika" (używane do odłączenia wirtualnego dysku DVD z dysku hosta lub z pliku ISO).

Jedynym ustawieniem, które różni się dla tego polecenia cmdlet według platformy wirtualizacji, jest to, czy plik ISO może być używany bezpośrednio z biblioteki programu VMM:

  • Host funkcji Hyper-V. Jeśli skonfigurujesz połączenie z plikiem ISO w bibliotece programu VMM, możesz użyć normy ISO bezpośrednio z biblioteki, zamiast kopiować je do hosta.

  • Host VMware ESX. W przypadku skonfigurowania połączenia z plikiem ISO w bibliotece programu VMM nie można użyć normy ISO bezpośrednio z biblioteki, ale zamiast tego musi zaakceptować wartość domyślną, która kopiuje plik ISO do hosta.

  • Host Citrix XenServer. W przypadku skonfigurowania połączenia z plikiem ISO w bibliotece programu VMM nie można użyć normy ISO bezpośrednio z biblioteki, ale zamiast tego musi zaakceptować wartość domyślną, która kopiuje plik ISO do hosta. Host musi mieć co najmniej jedno repozytorium ISO dostępne z dostępem do zapisu i wystarczającą ilością miejsca do magazynowania, aby zawierać plik ISO.

Uwaga: jeśli wirtualny dysk DVD jest skonfigurowany na maszynie wirtualnej, która została utworzona przy użyciu kreatora maszyny wirtualnej w konsoli Menedżera funkcji Hyper-V, a nie w konsoli programu VMM, należy określić literę dysku. Ta litera dysku będzie wyświetlana we właściwościach tej maszyny wirtualnej w konsoli programu VMM.

Przykłady

Przykład 1. Podłączanie wirtualnego dysku DVD do fizycznego dysku DVD

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

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

Drugie polecenie pobiera obiekt wirtualnego dysku DVD, który znajduje się w kanale pomocniczym 0 (określonym przez -Bus 1 i -LUN 0) w magistrali IDE na maszynie wirtualnej VM01 i przechowuje obiekt w zmiennej $DVDDrive.

Ostatnie polecenie łączy obiekt wirtualnego dysku DVD przechowywanego w $DVDDrive z dyskiem fizycznym na hoście (dysk D:). Usuwa również dowolny plik ISO używany wcześniej przez wirtualną stację DYSKÓW DVD, jeśli żadna inna maszyna wirtualna obecnie nie używa tego pliku ISO.

Przykład 2. Łączenie wirtualnego dysku DVD z inną lokalizacją w magistrali IDE

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

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

Drugie polecenie pobiera obiekt wirtualnego dysku DVD, który znajduje się w kanale pomocniczym 0 (określonym przez -Bus 1 i -LUN 0) w magistrali IDE na maszynie wirtualnej VM02, a następnie przechowuje obiekt wirtualnego dysku DVD w $DVDDrive.

Ostatnie polecenie łączy obiekt wirtualnego dysku DVD przechowywanego w $DVDDrive z inną pozycją w magistrali IDE, ustawiając numer jednostki logicznej (LUN) na 1.

Przykład 3. Odłącz wirtualny dysk DVD

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

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

Drugie polecenie pobiera obiekt wirtualnego dysku DVD, który znajduje się w kanale pomocniczym 0 (określonym przez -Bus 1 i -LUN 0) w magistrali IDE na maszynie wirtualnej VM03, a następnie przechowuje obiekt wirtualnego dysku DVD w $DVDDrive.

Ostatnie polecenie używa parametru NoMedia do odłączenia wirtualnego obiektu dysku DVD przechowywanego w $DVDDrive z dowolnego dysku hosta lub iso, z którym jest podłączony. Usuwa również dowolny plik ISO używany wcześniej przez wirtualną stację DYSKÓW DVD, jeśli żadna inna maszyna wirtualna obecnie nie używa tego pliku ISO.

Przykład 4. Podłączanie wirtualnego dysku DVD na istniejącej maszynie wirtualnej do dowolnej dostępnej fizycznej stacji dysków DVD

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> Set-SCVirtualDVDDrive -AnyVMHostDrive -VirtualDVDDrive (Get-VirtualDVDDrive -VM $VM | where {$_.Bus -eq 1 -and $_.Lun -eq 0})

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

Ostatnie polecenie pobiera obiekt wirtualnego dysku DVD, który znajduje się w pierwszym miejscu kanału pomocniczego (określonym przez -Bus 1 i -LUN 0) w magistrali IDE na maszynie wirtualnej VM04. Polecenie używa polecenia cmdlet Set-SCVirtualDVDDrive z parametrem AnyVMHostDrive w celu połączenia wirtualnego dysku DVD z dowolnym dostępnym fizycznym napędem DVD na hoście.

Parametry

-AnyVMHostDrive

Wskazuje, że wirtualny dysk DVD lub dyskietka na maszynie wirtualnej zostanie podłączony do dowolnego odpowiedniego dysku fizycznego na hoście. To mapowanie występuje podczas wdrażania przechowywanej maszyny wirtualnej na hoście lub gdy używasz szablonu lub profilu sprzętowego do tworzenia i wdrażania maszyny wirtualnej na hoście.

Type:SwitchParameter
Aliases:AnyHostDrive
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Bus

Określa magistralę IDE, do której ma zostać dołączony dysk wirtualny lub wirtualny dysk DVD, lub magistrala SCSI, do której ma zostać dołączony dysk wirtualny.

Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ISO

Określa obiekt ISO.

Type:ISO
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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ń.

Type:Guid
Position:Named
Default value:None
Required:True
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

-Link

Wskazuje, że zasób powinien być połączony zamiast kopiowany.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LUN

Określa numer jednostki logicznej (LUN) dla obiektu dysku wirtualnego lub obiektu wirtualnego dysku DVD w magistrali IDE lub obiektu dysku wirtualnego na magistrali SCSI.

  • Przykładowy format: -IDE -Bus 1 -LUN 0
  • Przykładowy format: -SCSI -Bus 0 -LUN 1
Type:Byte
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoMedia

Odłącza wirtualny dysk DVD z dysku hosta lub iso, z którym został podłączony, lub odłącza wirtualny dysk dyskietki z dysku hosta lub wirtualnego dysku dyskietki, z którym został podłączony.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Określa nazwę użytkownika. To polecenie cmdlet działa w imieniu użytkownika określonego przez ten parametr.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-SourceBus

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

Type:Byte
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SourceLUN

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

Type:Byte
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VirtualDVDDrive

Określa obiekt wirtualnego dysku DVD.

Type:VirtualDVDDrive
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMHostDrive

Określa dysk na hoście maszyny wirtualnej.

Przykładowe formaty:

  • Dysk twardy hosta funkcji Hyper-V: "C:"
  • Dyskietka hosta funkcji Hyper-V: "A:"
  • Dysk twardy hosta VMware ESX: "/dev/tools"
  • Dyskietka hosta VMware ESX: "/dev/sda"
  • Dysk twardy hosta Citrix XenServer: "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
  • Dyskietka hosta Citrix XenServer: nieobsługiwane
Type:String
Aliases:HostDrive
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Dane wyjściowe

VirtualDVDDrive

To polecenie cmdlet zwraca obiekt VirtualDVDDrive .

Uwagi

  • Wymaga obiektu wirtualnego dysku DVD programu VMM, który można pobrać za pomocą polecenia cmdlet Get-SCVirtualDVDDrive .