Udostępnij za pośrednictwem

New-SCVirtualScsiAdapter

  • Odwołanie
Moduł:
VirtualMachineManager

Tworzy wirtualną kartę SCSI na maszynie wirtualnej, szablonie maszyny wirtualnej lub profilu sprzętu używanym w programie VMM.

Składnia

New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -HardwareProfile <HardwareProfile>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVirtualScsiAdapter
   [-VMMServer <ServerConnection>]
   -JobGroup <Guid>
   [[-AdapterID] <Byte>]
   [-ShareVirtualScsiAdapter <Boolean>]
   [-Synthetic]
   [-ScsiControllerType <VMSCSIControllerType>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Opis

Polecenie cmdlet New-SCVirtualScsiAdapter tworzy wirtualną kartę SCSI na maszynie wirtualnej, szablonie maszyny wirtualnej lub profilu sprzętu używanym w środowisku programu Virtual Machine Manager (VMM). Po utworzeniu wirtualnej karty SCSI można użyć polecenia cmdlet Set-SCVirtualScsiAdapter, aby zmodyfikować jego ustawienia.

Uwaga: używanie parametru ShareVirtualScsiAdapter do udostępniania wirtualnej karty SCSI na maszynie wirtualnej w celu włączenia klastrowania gościa jest obsługiwane tylko wtedy, gdy maszyna wirtualna jest wdrożona na hoście ESX. Parametr SharedVirtualScsiAdapter nie jest używany dla maszyny wirtualnej na hoście Hyper-V, ponieważ maszyna wirtualna na hoście Hyper-V używa interfejsu iSCSI do magazynu udostępnionego.

Maszyna wirtualna na hoście Citrix XenServer zawsze ma jedną wirtualną kartę SCSI. Nie można usunąć tej karty ani dodać dodatkowych kart.

Przykłady

Przykład 1. Tworzenie wirtualnej karty SCSI na maszynie wirtualnej

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualScsiAdapter -VM $VM

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

Drugie polecenie tworzy wirtualną kartę SCSI na maszynie WIRTUALNEJ VM01.

Przykład 2. Tworzenie wirtualnej karty SCSI na szablonie maszyny wirtualnej

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> New-SCVirtualScsiAdapter -VMTemplate $VMTemplate

Pierwsze polecenie pobiera obiekt szablonu maszyny wirtualnej o nazwie VMTemplate01 z biblioteki programu VMM i przechowuje obiekt w zmiennej $VMTemplate.

Drugie polecenie tworzy wirtualną kartę SCSI na maszynie wirtualnej VmTemplate01.

Przykład 3. Tworzenie wirtualnej karty SCSI w profilu sprzętowym

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> New-SCVirtualScsiAdapter -HardwareProfile $HWProfile

Pierwsze polecenie pobiera obiekt profilu sprzętu o nazwie NewHWProfile01 z biblioteki programu VMM i przechowuje obiekt w zmiennej $HWProfile.

Drugie polecenie tworzy wirtualną kartę SCSI w systemie NewHWProfile01.

Parametry

-AdapterID

Określa numer jednostki logicznej lub identyfikator JEDNOSTKI LUN. Hyper-V i XenServer nie uwidaczniają tej wartości i nie można jej zmienić. W przypadku hosta VMware ESX wartość domyślna to 7 i nie można jej zmienić.

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

-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 ustawia w imieniu użytkownika jako 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. To polecenie cmdlet ustawia rolę użytkownika w imieniu użytkownika jako rolę użytkownika, którą określa ten parametr. Aby uzyskać obiekt roli użytkownika, użyj polecenia cmdlet Get-SCUserRole.

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

-ScsiControllerType

Określa typ kontrolera SCSI. Prawidłowe wartości to:

  • Typ domyślny
  • NoType
  • LsiLogic
  • BusLogic
  • ParaVirtualSCSI
  • LsiLogicSAS
Typ:VMSCSIControllerType
Dopuszczalne wartości:DefaultTypeNoType, LsiLogic, BusLogic, ParaVirtualSCSI, LsiLogicSAS
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ShareVirtualScsiAdapter

Wskazuje, czy wirtualna karta SCSI jest udostępniona, aby można było jej używać w klastrowaniu gościa.

  • host Hyper-V: nie (w przypadku klastrowania gościa użyj magazynu iSCSI)
  • Host XenServer: Nie (maszyny wirtualne Xen zawsze mają dokładnie jedną kartę SCSI)

Uwaga: podczas udostępniania kontrolera SCSI na maszynie wirtualnej na hoście ESX program VMM domyślnie zasady udostępniania SCSI w programie VMware są "fizyczne".

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

-Synthetic

Wskazuje, że urządzenie, takie jak wirtualna karta sieciowa, na maszynie wirtualnej wdrożonej na hoście Hyper-V jest urządzeniem syntetycznym o wysokiej wydajności. Wymaga systemu operacyjnego gościa obsługującego wirtualizację na maszynie wirtualnej.

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

-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

VirtualSCSIAdapter

To polecenie cmdlet zwraca obiekt VirtualSCSIAdapter.

Uwagi

  • Wymaga obiektu maszyny wirtualnej programu VMM, obiektu szablonu maszyny wirtualnej lub obiektu profilu sprzętowego, który można pobrać przy użyciu Get-SCVirtualMachine, Get-SCVMTemplatelub Get-SCHardwareProfile poleceń cmdlet.