New-SCVirtualDVDDrive
Tworzy wirtualny dysk DVD na maszynie wirtualnej, szablon maszyny wirtualnej lub profil sprzętu używany w programie VMM.
Składnia
New-SCVirtualDVDDrive
[-VMMServer <ServerConnection>]
-Bus <Byte>
-LUN <Byte>
[-Link]
-JobGroup <Guid>
[-ISO <ISO>]
[-VMHostDrive <String>]
[-AnyVMHostDrive]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
New-SCVirtualDVDDrive
-Bus <Byte>
-LUN <Byte>
[-Link]
-HardwareProfile <HardwareProfile>
[-ISO <ISO>]
[-VMHostDrive <String>]
[-AnyVMHostDrive]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
New-SCVirtualDVDDrive
-Bus <Byte>
-LUN <Byte>
[-Link]
-VM <VM>
[-ISO <ISO>]
[-VMHostDrive <String>]
[-AnyVMHostDrive]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
New-SCVirtualDVDDrive
-Bus <Byte>
-LUN <Byte>
[-Link]
-VMTemplate <Template>
[-ISO <ISO>]
[-VMHostDrive <String>]
[-AnyVMHostDrive]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Opis
Polecenie cmdlet New-SCVirtualDVDDrive tworzy obiekt wirtualnego dysku DVD na maszynie wirtualnej, szablonie maszyny wirtualnej lub profilu sprzętu używanym w środowisku programu Virtual Machine Manager (VMM). Domyślnie wirtualna stacja DYSKÓW DVD utworzona przez New-SCVirtualDVDDrive nie jest podłączona do żadnego nośnika. Możesz użyć polecenia cmdlet Set-SCVirtualDVDDrive, aby połączyć wirtualny dysk DVD z fizyczną stacją DYSKÓW DVD na hoście maszyny wirtualnej lub z obrazem ISO.
Uwaga: wirtualny dysk DVD można podłączyć do urządzenia IDE na maszynie wirtualnej, ale nie można podłączyć wirtualnej stacji DYSKÓW DVD do karty SCSI na maszynie wirtualnej.
Przykłady
Przykład 1. Tworzenie wirtualnej stacji dysków DVD na maszynie wirtualnej
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualDVDDrive -VM $VM -Bus 1 -LUN 1
Pierwsze polecenie pobiera obiekt maszyny wirtualnej o nazwie VM01 i przechowuje obiekt w zmiennej $VM.
Drugie polecenie tworzy wirtualną stację DYSKÓW DVD na maszynie VM01 i dołącza wirtualną stację DYSKÓW DVD do kanału pomocniczego (1), określając magistralę IDE 1 i numer LUN 1.
Przykład 2. Tworzenie wirtualnej stacji dysków DVD na szablonie maszyny wirtualnej
PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> New-SCVirtualDVDDrive -VMTemplate $VMTemplate -Bus 1 -LUN 1
Pierwsze polecenie pobiera obiekt templat maszyny wirtualnej o nazwie VMTemplate01 i przechowuje obiekt w zmiennej $Template.
Drugie polecenie tworzy wirtualny dysk DVD na maszynie wirtualnej VmTemplate01, który dołącza wirtualny dysk DVD do kanału pomocniczego (1) w magistrali IDE, gdy szablon jest używany do tworzenia maszyny wirtualnej.
Przykład 3. Tworzenie wirtualnej stacji DYSKÓW DVD w profilu sprzętowym
PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> New-SCVirtualDVDDrive -HardwareProfile $HWProfile -Bus 1 -LUN 1
Pierwsze polecenie pobiera obiekt profilu sprzętu o nazwie NewHardwareProfile01 i przechowuje obiekt w zmiennej $HWProfile.
Drugie polecenie tworzy wirtualny dysk DVD na hardwareProfile1, który dołącza wirtualny dysk DVD do kanału pomocniczego (1) w magistrali IDE, gdy profil sprzętu jest używany do tworzenia maszyny wirtualnej.
Przykład 4: Tworzenie maszyny wirtualnej z wirtualną stacją DYSKÓW DVD, która łączy się z dowolną dostępną fizyczną stacją DYSKÓW DVD na hoście
PS C:\> $JobGroupId = [Guid]::NewGuid().ToString()
PS C:\> New-SCVirtualDVDDrive -VMMServer "VMMServer01.Contoso.com" -JobGroup $JobGroupId -Bus 1 -LUN 0 -AnyVMHostDrive
PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost04"
PS C:\> New-SCVirtualMachine -Name "VM04" -Description "A new VM with a DVD drive" -VMMServer "VMMServer01.Contoso.com" -Owner "Contoso\Katarina" -VMHost $VMHost -Path "D:\VirtualMachinePath" -StartVM -JobGroup $JobGroupId
Pierwsze polecenie tworzy nowy ciąg identyfikatora GUID i zapisuje go w zmiennej $JobGroupID. Ten identyfikator GUID jest identyfikatorem grupy zadań, który działa jako identyfikator grupujący kolejne polecenia, które zawierają ten identyfikator w jednej grupie zadań.
Drugie polecenie tworzy nowy wirtualny obiekt stacji dysków DVD i określa, że ta nowa wirtualna stacja DVD może używać dowolnej dostępnej fizycznej stacji dysków DVD. Polecenie dołączy nową wirtualną stację DYSKÓW DVD do pierwszego miejsca drugiego kanału IDE (IDE jest jedynym typem magistrali, do którego można podłączyć wirtualną stację DVD). Przy użyciu identyfikatora grupy zadań określa, że to polecenie nie jest uruchamiane dopiero przed ostatnim poleceniem zawierającym JobGroup uruchomienia parametru.
Trzecie polecenie pobiera obiekt hosta o nazwie VMHost04 i przechowuje obiekt w zmiennej $VMHost.
Ostatnie polecenie tworzy maszynę wirtualną, nada jej nazwę VM04, zawiera opis, przypisuje właściciela i określa lokalizację na hoście do przechowywania maszyny wirtualnej. Polecenie używa identyfikatora grupy zadań do uruchomienia polecenia New-SCVirtualDVDDrive tuż przed uruchomieniem polecenia New-SCVirtualMachine; wynikowy obiekt wirtualnego dysku DVD jest skojarzony z nową maszyną wirtualną.
Przykład 5: Dodawanie nowej wirtualnej stacji DYSKÓW DVD do istniejącej maszyny wirtualnej i dołączanie pliku ISO z biblioteki do dysku
PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $ISO = Get-SCISO | where {$_.Name -eq "WindowsServer2008R2.iso"}
PS C:\> New-SCVirtualDVDDrive -VM $VM -ISO $ISO -Bus 1 -LUN 1
Pierwsze polecenie pobiera obiekt maszyny wirtualnej o nazwie VM05 i przechowuje obiekt w zmiennej $VM.
Drugie polecenie pobiera obiekt ISO o nazwie WindowsServer2008R2.iso i przechowuje obiekt w zmiennej $ISO.
Ostatnie polecenie tworzy nową wirtualną stację DYSKÓW DVD na maszynie VM05, dołącza ją do określonej lokalizacji w magistrali IDE i łączy ją z obrazem ISO przechowywanym w $ISO.
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.
Typ: | SwitchParameter |
Aliasy: | AnyHostDrive |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Bus
Określa magistralę IDE, do której należy dołączyć stację dysków wirtualnych lub wirtualny dysk DVD, lub magistralę SCSI, do której ma zostać dołączony dysk wirtualny.
Typ: | Byte |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-HardwareProfile
Określa obiekt profilu sprzętowego.
Typ: | HardwareProfile |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-ISO
Określa obiekt ISO.
Typ: | ISO |
Position: | Named |
Domyślna wartość: | None |
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 |
-Link
Wskazuje, że zasób powinien być połączony zamiast kopiowany.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-LUN
Określa numer jednostki logicznej (LUN) dla obiektu dysku wirtualnego lub dla obiektu wirtualnego dysku DVD w magistrali IDE lub dla obiektu dysku wirtualnego w magistrali SCSI.
- Przykładowy format:
-IDE -Bus 1 -LUN 0
- Przykładowy format:
-SCSI -Bus 0 -LUN 1
Typ: | Byte |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
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 |
-VM
Określa obiekt maszyny wirtualnej.
Typ: | VM |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-VMHostDrive
Określa dysk na hoście maszyny wirtualnej.
Przykładowe formaty:
- dysk twardy hosta Hyper-V:
"C:"
- Hyper-V stacji dyskietek hosta:
"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
Typ: | String |
Aliasy: | HostDrive |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-VMMServer
Określa obiekt serwera programu VMM.
Typ: | ServerConnection |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-VMTemplate
Określa obiekt szablonu programu VMM używany do tworzenia maszyn wirtualnych.
Typ: | Template |
Aliasy: | Template |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
Dane wyjściowe
VirtualDVDDrive
To polecenie cmdlet zwraca obiekt VirtualDVDDrive.
Uwagi
- Wymaga obiektu maszyny wirtualnej programu VMM, obiektu szablonu maszyny wirtualnej lub obiektu profilu sprzętu. Te obiekty można pobrać przy użyciu Get-SCVirtualMachine, Get-SCVMTemplatelub polecenia cmdlet Get-SCHardwareProfile.