Sdílet prostřednictvím

New-SCVirtualScsiAdapter

  • Reference
Modul:
VirtualMachineManager

Vytvoří virtuální adaptér SCSI na virtuálním počítači, šabloně virtuálního počítače nebo hardwarovém profilu použitém v nástroji VMM.

Syntaxe

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>]

Description

Rutina New-SCVirtualScsiAdapter vytvoří virtuální adaptér SCSI na virtuálním počítači, šabloně virtuálního počítače nebo profilu hardwaru používaném v prostředí nástroje Virtual Machine Manager (VMM). Po vytvoření virtuálního adaptéru SCSI můžete k úpravě nastavení použít rutinu Set-SCVirtualScsiAdap ter.

Poznámka: Použití parametru ShareVirtualScsiAdapter ke sdílení virtuálního adaptéru SCSI na virtuálním počítači, aby bylo možné povolit clustering hostů, je podporováno pouze v případě, že je virtuální počítač nasazený na hostiteli ESX. Parametr SharedVirtualScsiAdapter se nepoužívá pro virtuální počítač na hostiteli Hyper-V, protože virtuální počítač na hostiteli Hyper-V používá pro sdílené úložiště iSCSI.

Virtuální počítač na hostiteli Citrix XenServer má vždy jeden virtuální adaptér SCSI. Tento adaptér nelze odebrat ani přidat další adaptéry.

Příklady

Příklad 1: Vytvoření virtuálního adaptéru SCSI na virtuálním počítači

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

První příkaz získá objekt virtuálního počítače s názvem VM01 a uloží ho do proměnné $VM.

Druhý příkaz vytvoří virtuální adaptér SCSI na virtuálním počítači VM01.

Příklad 2: Vytvoření virtuálního adaptéru SCSI v šabloně virtuálního počítače

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

První příkaz získá objekt šablony virtuálního počítače s názvem VMTemplate01 z knihovny VMM a uloží objekt do proměnné $VMTemplate.

Druhý příkaz vytvoří virtuální adaptér SCSI na virtuálním počítači VMTemplate01.

Příklad 3: Vytvoření virtuálního adaptéru SCSI v hardwarovém profilu

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

První příkaz získá objekt profilu hardwaru s názvem NewHWProfile01 z knihovny VMM a uloží objekt do proměnné $HWProfile.

Druhý příkaz vytvoří virtuální adaptér SCSI na NewHWProfile01.

Parametry

-AdapterID

Určuje číslo logické jednotky nebo ID logické jednotky. Hyper-V a XenServer tuto hodnotu nezpřístupňují a nelze ji změnit. Pro hostitele VMware ESX je výchozí hodnota 7 a nelze ji změnit.

Typ:Byte
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-HardwareProfile

Určuje objekt hardwarového profilu.

Typ:HardwareProfile
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-JobGroup

Určuje identifikátor pro řadu příkazů, které se spustí jako sada těsně před posledním příkazem, který obsahuje stejné spuštění identifikátoru skupiny úloh.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-JobVariable

Určuje, že průběh úlohy je sledován a uložen v proměnné pojmenované tímto parametrem.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnBehalfOfUser

Určuje jméno uživatele. Tato rutina nastaví jménem uživatele jako uživatele, který určuje tento parametr.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnBehalfOfUserRole

Určuje roli uživatele. Tato rutina nastaví roli uživatele jménem uživatele jako roli uživatele, kterou tento parametr určuje. K získání objektu role uživatele použijte rutinu Get-SCUserRole.

Typ:UserRole
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RunAsynchronously

Označuje, že úloha běží asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ScsiControllerType

Určuje typ kontroleru SCSI. Platné hodnoty jsou:

  • DefaultTypeNoType
  • LsiLogic
  • BusLogic
  • ParaVirtualSCSI
  • LsiLogicSAS
Typ:VMSCSIControllerType
Přípustné hodnoty:DefaultTypeNoType, LsiLogic, BusLogic, ParaVirtualSCSI, LsiLogicSAS
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ShareVirtualScsiAdapter

Určuje, jestli je virtuální adaptér SCSI sdílený, aby ho bylo možné použít v clusteringu hostů.

  • Hyper-V hostitel: Ne (pro clustering hostů použijte úložiště iSCSI)
  • Hostitel XenServer: Ne (virtuální počítače Xen vždy mají přesně jeden adaptér SCSI)

Poznámka: Při sdílení kontroleru SCSI na virtuálním počítači na hostiteli ESX použije nástroj VMM výchozí zásady sdílení SCSI ve VMware na "fyzické".

Typ:Boolean
Aliasy:Shared
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Synthetic

Označuje, že zařízení, například virtuální síťový adaptér, na virtuálním počítači nasazené na Hyper-V hostiteli je vysoce výkonné syntetické zařízení. Vyžaduje hostovaný operační systém pracující s virtualizací na virtuálním počítači.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VM

Určuje objekt virtuálního počítače.

Typ:VM
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VMMServer

Určuje objekt serveru VMM.

Typ:ServerConnection
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VMTemplate

Určuje objekt šablony VMM použitý k vytvoření virtuálních počítačů.

Typ:Template
Aliasy:Template
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Výstupy

VirtualSCSIAdapter

Tato rutina vrátí objekt VirtualSCSIAdapter.

Poznámky

  • Vyžaduje objekt virtuálního počítače VMM, objekt šablony virtuálního počítače nebo objekt profilu hardwaru, který lze načíst pomocí rutin Get-SCVirtualMachine, Get-SCVMTemplatenebo Get-SCHardwareProfile rutin.