New-SCVirtualScsiAdapter
VMM에서 사용되는 가상 머신, 가상 머신 템플릿 또는 하드웨어 프로필에 가상 SCSI 어댑터를 만듭니다.
구문
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
New-SCVirtualScsiAdapter cmdlet은 가상 머신, 가상 머신 템플릿 또는 VMM(Virtual Machine Manager) 환경에서 사용되는 하드웨어 프로필에 가상 SCSI 어댑터를 만듭니다. 가상 SCSI 어댑터를 만든 후 Set-SCVirtualScsiAdapter cmdlet을 사용하여 설정을 수정할 수 있습니다.
참고: 게스트 클러스터링을 사용하도록 설정하기 위해 ShareVirtualScsiAdapter 매개 변수를 사용하여 가상 머신에서 가상 SCSI 어댑터를 공유하는 것은 가상 머신이 ESX 호스트에 배포된 경우에만 지원됩니다. Hyper-V 호스트의 가상 머신이 공유 스토리지에 iSCSI를 사용하므로 SharedVirtualScsiAdapter 매개 변수는 Hyper-V 호스트의 가상 머신에 사용되지 않습니다.
Citrix XenServer 호스트의 가상 머신에는 항상 하나의 가상 SCSI 어댑터가 있습니다. 이 어댑터를 제거하거나 어댑터를 추가할 수 없습니다.
예제
예제 1: 가상 머신에 가상 SCSI 어댑터 만들기
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> New-SCVirtualScsiAdapter -VM $VM
첫 번째 명령은 VM01이라는 가상 머신 개체를 가져오고 개체를 $VM 변수에 저장합니다.
두 번째 명령은 VM01에 가상 SCSI 어댑터를 만듭니다.
예제 2: 가상 머신 템플릿에 가상 SCSI 어댑터 만들기
PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> New-SCVirtualScsiAdapter -VMTemplate $VMTemplate
첫 번째 명령은 VMM 라이브러리에서 VMTemplate01이라는 가상 머신 템플릿 개체를 가져오고 개체를 $VMTemplate 변수에 저장합니다.
두 번째 명령은 VMTemplate01에 가상 SCSI 어댑터를 만듭니다.
예제 3: 하드웨어 프로필에 가상 SCSI 어댑터 만들기
PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> New-SCVirtualScsiAdapter -HardwareProfile $HWProfile
첫 번째 명령은 VMM 라이브러리에서 NewHWProfile01이라는 하드웨어 프로필 개체를 가져오고 개체를 $HWProfile 변수에 저장합니다.
두 번째 명령은 NewHWProfile01에 가상 SCSI 어댑터를 만듭니다.
매개 변수
-AdapterID
논리 단위 번호 또는 LUN ID를 지정합니다. Hyper-V 및 XenServer는 이 값을 노출하지 않으며 변경할 수 없습니다. VMware ESX 호스트의 경우 기본값은 7이며 변경할 수 없습니다.
형식: | Byte |
Position: | 0 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-HardwareProfile
하드웨어 프로필 개체를 지정합니다.
형식: | HardwareProfile |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-JobGroup
동일한 작업 그룹 식별자를 포함하는 최종 명령이 실행되기 직전에 집합으로 실행되는 일련의 명령에 대한 식별자를 지정합니다.
형식: | Guid |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-JobVariable
작업 진행률이 추적되고 이 매개 변수로 명명된 변수에 저장되도록 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-OnBehalfOfUser
사용자의 이름을 지정합니다. 이 cmdlet은 사용자를 대신하여 이 매개 변수가 지정하는 사용자로 설정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-OnBehalfOfUserRole
사용자 역할을 지정합니다. 이 cmdlet은 사용자 역할을 대신하여 이 매개 변수가 지정하는 사용자 역할로 설정합니다. 사용자 역할 개체를 가져오려면 Get-SCUserRole cmdlet을 사용합니다.
형식: | UserRole |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-PROTipID
이 작업을 트리거한 PRO 팁(성능 및 리소스 최적화 팁)의 ID를 지정합니다. 이 매개 변수를 사용하면 PRO 팁을 감사할 수 있습니다.
형식: | Guid |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-RunAsynchronously
컨트롤이 명령 셸로 즉시 반환되도록 작업이 비동기적으로 실행됨을 나타냅니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ScsiControllerType
SCSI 컨트롤러 유형을 지정합니다. 유효한 값은 다음과 같습니다.
- DefaultType
- NoType
- LsiLogic
- BusLogic
- ParaVirtualSCSI
- LsiLogicSAS
형식: | VMSCSIControllerType |
허용되는 값: | DefaultTypeNoType, LsiLogic, BusLogic, ParaVirtualSCSI, LsiLogicSAS |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ShareVirtualScsiAdapter
게스트 클러스터링에서 사용할 수 있도록 가상 SCSI 어댑터가 공유되는지 여부를 나타냅니다.
- Hyper-V 호스트: 아니요(게스트 클러스터링의 경우 iSCSI 스토리지 사용)
- XenServer 호스트: 아니요(Xen VM에는 항상 정확히 하나의 SCSI 어댑터가 있습니다.)
참고: ESX 호스트의 가상 머신에서 SCSI 컨트롤러를 공유하는 경우 VMM은 기본적으로 VMware의 SCSI 공유 정책을 "물리적"으로 설정합니다.
형식: | Boolean |
별칭: | Shared |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Synthetic
Hyper-V 호스트에 배포된 가상 머신의 가상 네트워크 어댑터와 같은 디바이스가 고성능 가상 디바이스임을 나타냅니다. 가상 머신에 가상화 인식 게스트 운영 체제가 필요합니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-VM
가상 머신 개체를 지정합니다.
형식: | VM |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-VMMServer
VMM 서버 개체를 지정합니다.
형식: | ServerConnection |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-VMTemplate
가상 머신을 만드는 데 사용되는 VMM 템플릿 개체를 지정합니다.
형식: | Template |
별칭: | Template |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
출력
VirtualSCSIAdapter
이 cmdlet은 VirtualSCSIAdapter 개체를 반환합니다.
참고
- Get-SCVirtualMachine, get-SCVMTemplate
또는 Get-SCHardwareProfile cmdlet을 각각 사용하여 검색할 수 있는 VMM 가상 머신 개체, 가상 머신 템플릿 개체 또는 하드웨어 프로필 개체가 필요합니다.