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 funkcji Hyper-V, ponieważ maszyna wirtualna na hoście funkcji 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ętowego 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. Funkcje 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ć.

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

-HardwareProfile

Określa obiekt profilu sprzętowego.

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

-OnBehalfOfUser

Określa nazwę użytkownika. To polecenie cmdlet ustawia wartość w imieniu użytkownika jako 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. 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 .

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

-ScsiControllerType

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

  • DefaultType
  • NoType
  • LsiLogic
  • BusLogic
  • ParaVirtualSCSI
  • LsiLogicSAS
Type:VMSCSIControllerType
Accepted values:DefaultTypeNoType, LsiLogic, BusLogic, ParaVirtualSCSI, LsiLogicSAS
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ShareVirtualScsiAdapter

Wskazuje, czy wirtualna karta SCSI jest współużytkowana, aby mogła być używana w klastrze gościa.

  • Host funkcji 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 domyślnie zasady udostępniania SCSI w programie VMware są "fizyczne".

Type:Boolean
Aliases:Shared
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Synthetic

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

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

-VM

Określa obiekt maszyny wirtualnej.

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

-VMMServer

Określa obiekt serwera programu VMM.

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

-VMTemplate

Określa obiekt szablonu programu VMM używany do tworzenia maszyn wirtualnych.

Type:Template
Aliases:Template
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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ętu, który można pobrać przy użyciu odpowiednio poleceń cmdlet Get-SCVirtualMachine, Get-SCVMTemplate lub Get-SCHardwareProfile .