New-SCVirtualNetworkAdapter

모듈:

VirtualMachineManager

VMM에서 사용되는 가상 머신, 가상 머신 템플릿 또는 하드웨어 프로필에 가상 네트워크 어댑터를 만듭니다.

Syntax

New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   -VM <VM>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualNetworkAdapter
   [-VMMServer <ServerConnection>]
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   [-VMHost <Host>]
   [-LogicalSwitch <LogicalSwitch>]
   -JobGroup <Guid>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   -VMTemplate <Template>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-EnableMACAddressSpoofing <Boolean>]
   [-EnableGuestIPNetworkVirtualizationUpdates <Boolean>]
   [-EnableVMNetworkOptimization <Boolean>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-DevicePropertiesAdapterNameMode <DevicePropertiesAdapterNameMode>]
   [-AdapterFlags <VirtualNetworkAdapterFlags>]
   -HardwareProfile <HardwareProfile>
   [[-VirtualNetwork] <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-NoConnection]
   [-Synthetic]
   [-LogicalNetwork <LogicalNetwork>]
   [-VMNetworkServiceSetting <String>]
   [-NoVMNetwork]
   [-VMwarePortGroup <String>]
   [-NetworkLocation <String>]
   [-NetworkTag <String>]
   [-DevicePropertiesAdapterName <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCVirtualNetworkAdapter
   [-IPv4AddressType <EthernetAddressType>]
   [-IPv6AddressType <EthernetAddressType>]
   [-VMNetwork <VMNetwork>]
   [-PortClassification <PortClassification>]
   [-VMSubnet <VMSubnet>]
   [-VLanEnabled <Boolean>]
   [-VLanID <UInt16>]
   [-IPv4AddressPool <StaticIPAddressPool>]
   [-IPv6AddressPool <StaticIPAddressPool>]
   [-InheritsAddressFromPhysicalNetworkAdapter <Boolean>]
   -VMHost <Host>
   -LogicalSwitch <LogicalSwitch>
   [-JobGroup <Guid>]
   [-Name <String>]
   [-MACAddress <String>]
   [-MACAddressType <String>]
   [-IPv4Address <String>]
   [-IPv6Address <String>]
   [-PortACL <PortACL>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

New-SCVirtualNetworkAdapter cmdlet은 VMM(Virtual Machine Manager)에서 관리하는 가상 머신을 만드는 데 사용되는 가상 머신, 가상 머신 템플릿 또는 하드웨어 프로필에 가상 네트워크 어댑터를 만듭니다.

네트워크 위치

New-SCVirtualNetworkAdapter cmdlet을 사용하여 네트워크 위치를 지정하고 어댑터를 만들 때 호스트에 구성된 가상 네트워크에 가상 네트워크 어댑터를 연결하거나 나중에 Set-SCVirtualNetworkAdapter cmdlet을 사용하여 해당 설정 및 기타 설정을 구성할 수 있습니다.

정적 또는 동적 MAC 주소

가상 네트워크 어댑터가 정적 또는 동적 MAC 주소를 사용하는지 여부를 지정할 수 있으며 정적 MAC 주소를 지정할 수 있습니다.

에뮬레이트 또는 가상 Virtual Network 어댑터

New-SCVirtualNetworkAdapter cmdlet을 사용하여 형식이 에뮬레이트(기본값) 또는 가상인 어댑터를 만들 수 있습니다.

모든 유형의 호스트(Hyper-V, VMware 또는 XenServer)에 있는 가상 머신의 경우 가상 머신에서 특정 물리적 네트워크 어댑터를 에뮬레이트하는 가상 네트워크 어댑터를 구성할 수 있습니다.

Hyper-V 호스트의 가상 머신의 경우 가상 머신에 설치된 게스트 운영 체제가 가상화 인식 운영 체제(예: Windows Server 2008 또는 Windows Server 2016 및 일부 버전의 Linux)인 경우 VMM을 사용하면 호스트의 실제 하드웨어와 통신하도록 가상 머신에서 고성능 가상 네트워크 어댑터를 구성할 수 있습니다. 가상 네트워크 어댑터가 가상 매개 변수를 사용하여 가상 네트워크 어댑터가 가상인지 명시적으로 지정해야 합니다.

가상 로컬 영역 네트워크

VMM에는 해당 호스트에 배포된 가상 머신에서 사용할 호스트에 하나 이상의 VLAN(가상 영역 네트워크)을 구성하는 지원이 포함되어 있습니다. VLAN 매개 변수와 함께 New-SCVirtualNetworkAdapter cmdlet(또는 Set-SCVirtualNetworkAdapter cmdlet)을 사용하여 가상 머신의 가상 네트워크 어댑터를 VLAN에 연결할 수 있습니다. 호스트 네트워크 어댑터에서 해당 VLAN 설정을 구성하려면 Add-SCVMHostNetworkAdapter cmdlet 또는 Set-SCVMHostNetworkAdapter cmdlet을 사용합니다.

VLAN을 구성하는 방법에 대한 그림은 이 cmdlet에 대한 예제를 참조하고 New-SCVMHostNetworkAdapterConfig 및 Set-SCVMHostNetworkAdapter에 대한 예제를 참조하세요.

참고

• 새 매개 변수 [-PhysicalNetworkAdapterName] 은 VMM 2019 UR2 이상에 포함됩니다. 자세한 내용은 매개 변수를 참조하세요.
• 새 매개 변수 [-AllowedVLanList] 및 [-NativeVLanId] 는 VMM 2019 UR3 이상에 포함됩니다. 자세한 내용은 매개 변수를 참조하세요.

예제

예제 1: 가상 머신에서 가상 네트워크 어댑터 만들기

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

첫 번째 명령은 VM01이라는 가상 머신 개체를 가져오고 개체를 $VM 변수에 저장합니다.

두 번째 명령은 VM01에 가상 네트워크 어댑터를 만듭니다.

예제 2: 가상 머신 템플릿에서 가상 네트워크 어댑터 만들기

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

첫 번째 명령은 VMTemplate01이라는 가상 머신 템플릿 개체를 가져오고 개체를 $VMTemplate 변수에 저장합니다.

두 번째 명령은 VMTemplate01에 가상 네트워크 어댑터를 만듭니다.

예제 3: 하드웨어 프로필에 에뮬레이트된 가상 네트워크 어댑터 및 가상 가상 네트워크 어댑터 만들기

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

첫 번째 명령은 VMM 라이브러리에서 NewHWProfile01이라는 하드웨어 프로필 개체를 가져오고 개체를 $HWProfile 변수에 저장합니다.

두 번째 명령은 NewHWProfile01에 가상 네트워크 어댑터("네이티브" 또는 에뮬레이트된 어댑터)를 만듭니다.

마지막 명령은 NewHWProfile01에 가상 가상 네트워크 어댑터를 만듭니다.

예제 4: 가상 머신에 가상 네트워크 어댑터 만들기 및 고유한 MAC 주소 할당

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $VNIC = New-SCVirtualNetworkAdapter -VM $VM
PS C:\> $MACPool = Get-SCMACAddressPool -Name "MAC Address Pool 01"
PS C:\> Grant-SCMACAddress -MACAddressPool $MACPool -VirtualNetworkAdapter $VNIC

첫 번째 명령은 VM04라는 가상 머신 개체를 가져오고 개체를 $VM 변수에 저장합니다.

두 번째 명령은 $VM(VM04)에 저장된 가상 머신에 가상 네트워크 어댑터를 만들고 개체를 $VNIC 변수에 저장합니다.

세 번째 명령은 MAC 주소 풀 01이라는 MAC 주소 풀 개체를 가져오고 개체를 $MACPool 변수에 저장합니다.

마지막 명령은 $MACPool 저장된 주소 풀에서 사용 가능한 다음 MAC 주소를 가져오고 $VNIC 저장된 가상 네트워크 어댑터에 할당합니다.

예제 5: 정적 MAC 주소 및 특정 VLAN ID를 사용하여 가상 네트워크 어댑터 만들기

PS C:\> $VM = Get-SCVirtualMachine -Name "VM05"
PS C:\> $LogicalNet = Get-SCLogicalNetwork -Name "LogicalNetwork01"
PS C:\> $VirtualNet = Get-SCVirtualNetwork -Name "ExternalVirtualNetwork01"
PS C:\> New-SCVirtualNetworkAdapter -VM $VM -LogicalNetwork $LogicalNet -VirtualNetwork $VirtualNet -MACAddress "00-16-D3-CC-00-1A" -MACAddressType "Static" -VLANEnabled $True -VLANId 3

첫 번째 명령은 VM05라는 가상 머신 개체를 가져오고 개체를 $VM 변수에 저장합니다.

두 번째 명령은 LogicalNetwork01이라는 논리 네트워크 개체를 가져오고 개체를 $LogicalNet 변수에 저장합니다.

세 번째 명령은 ExternalVirtualNetwork01이라는 가상 네트워크 개체를 가져오고 개체를 $VirtualNet 변수에 저장합니다.

마지막 명령은 VM05용 새 가상 네트워크 어댑터를 만들고 어댑터를 $LogicalNet 저장된 논리 네트워크 및 $VirtualNet 저장된 가상 네트워크에 연결합니다. 명령은 가상 네트워크 어댑터에 대한 정적 MAC 주소를 제공하고, VLAN을 사용하도록 설정하고, VLAN ID 3을 지정합니다.

참고: 이 예제에서는 호스트가 이미 VLAN에 연결되어 있다고 가정하거나, 그렇지 않은 경우 호스트에 두 개의 네트워크 어댑터가 있다고 가정합니다. 호스트에 단일 네트워크 어댑터가 있는 경우 VMM 서버에서 사용할 수 없는 VLAN에 어댑터를 할당하면 VMM에서 호스트를 관리할 수 없습니다.

매개 변수

-AdapterFlags

{{Fill AdapterFlags Description}}

Type:	VirtualNetworkAdapterFlags
Accepted values:	None, ApplyInfrastructurePortProfileForNetworkController, ApplyNCPortProfileForNetworkController, ApplyInstaceIDPortProfileForNetworkController
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowedVLanList

가상 컴퓨터 네트워크 어댑터에서 허용되는 가상 LAN 목록을 지정합니다.

참고

이 매개 변수는 VMM 2019 UR3 이상에 적용할 수 있습니다.

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

-DevicePropertiesAdapterName

네트워크 어댑터의 이름을 지정합니다.

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

-DevicePropertiesAdapterNameMode

어댑터 이름 모드를 지정합니다.

Type:	DevicePropertiesAdapterNameMode
Accepted values:	Disabled, VMNetwork, Custom
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableGuestIPNetworkVirtualizationUpdates

게스트의 IP 네트워크 가상화 업데이트를 사용할 수 있는지 여부를 나타냅니다.

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

-EnableMACAddressSpoofing

를 $True 설정하면 MAC 주소 스푸핑을 사용하도록 설정합니다.

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

-EnableVMNetworkOptimization

$True 설정하면 가상 머신 네트워크 최적화를 사용하도록 설정합니다.

이 기능은 VMQ(가상 머신 큐) 또는 TCP 굴뚝 오프로드를 지원하는 네트워크 어댑터가 있는 가상 머신의 네트워크 성능을 향상시킵니다. VMQ를 사용하면 각 가상 네트워크 어댑터에 대해 고유한 네트워크 큐를 만들 수 있습니다. TCP Chimney 오프로드를 사용하면 네트워크 트래픽 처리를 네트워킹 스택에서 오프로드할 수 있습니다.

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

-HardwareProfile

하드웨어 프로필 개체를 지정합니다.

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

-InheritsAddressFromPhysicalNetworkAdapter

네트워크 어댑터가 실제 네트워크 어댑터에서 주소를 상속하는지 여부를 나타냅니다.

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

-IPv4Address

IPv4 주소를 지정합니다.

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

-IPv4AddressPool

IPv4 주소를 포함하는 정적 주소 풀을 지정합니다.

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

-IPv4AddressType

IPv4 주소 유형을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

• 동적
• 정적

Type:	EthernetAddressType
Accepted values:	Dynamic, Static
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IPv6Address

IPv6 주소를 지정합니다.

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

-IPv6AddressPool

IPv6 주소를 포함하는 정적 주소 풀을 지정합니다.

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

-IPv6AddressType

IPv6 주소 유형을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

• 동적
• 정적

Type:	EthernetAddressType
Accepted values:	Dynamic, Static
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-JobGroup

동일한 작업 그룹 식별자를 포함하는 마지막 명령이 실행되기 직전에 하나의 집합으로 실행되는 일련의 명령에 대한 식별자를 지정합니다.

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

-JobVariable

작업 진행률을 추적하여 이 매개 변수로 이름이 지정된 변수에 보관하도록 지정합니다.

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

-LogicalNetwork

논리 네트워크를 지정합니다. 논리 네트워크는 네트워크 할당을 구성하고 간소화하는 데 사용되는 IP 서브넷 및 VLAN의 명명된 그룹화입니다.

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

-LogicalSwitch

논리 스위치 개체를 지정합니다.

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

-MACAddress

컴퓨터의 물리적 또는 가상 네트워크 어댑터에 대한 MAC 주소 또는 MAC 주소 집합을 지정합니다.

• 단일 MAC 주소에 대한 예제 형식: -MACAddress "00-15-5D-B4-DC-00"
• MAC 주소 집합에 대한 예제 형식: -MACAddress "00-15-5D-B4-DC-00", "00-1A-A0-E3-75-29"

Type:	String
Aliases:	EthernetAddress, PhysicalAddress
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MACAddressType

가상 네트워크 어댑터에 사용할 MAC 주소 유형을 지정합니다. 유효한 값은 Static, Dynamic입니다.

Type:	String
Aliases:	EthernetAddressType, PhysicalAddressType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

네트워크 개체의 이름을 지정합니다.

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

-NativeVLanId

가상 컴퓨터 네트워크 어댑터의 기본 가상 LAN 식별자를 지정합니다.

참고

이 매개 변수는 VMM 2019 UR3 이상에 적용할 수 있습니다.

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

-NetworkLocation

실제 네트워크 어댑터 또는 가상 네트워크 어댑터에 대해 네트워크 위치를 지정하거나 호스트의 실제 네트워크 어댑터에 대한 기본 네트워크 위치를 변경합니다.

예제 형식: -NetworkLocation $NetLoc ($NetLoc Corp.Contoso.com 포함될 수 있습니다.) -OverrideNetworkLocation $True -NetworkLocation "HostNICNewLocation.Contoso.com"

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

-NetworkTag

호스트의 특정 내부 또는 외부 네트워크에 연결하도록 구성된 가상 네트워크 어댑터에 연결할 단어나 구를 지정합니다.

NetworkTag 매개 변수는 동일한 네트워크의 멤버와 동일한 NetworkTag를 가진 모든 가상 머신을 식별합니다. VMM은 가상 머신을 배포할 가능한 후보로 호스트를 평가할 때 NeworkTag (있는 경우)를 사용합니다. 호스트가 배치할 가상 머신과 동일한 NetworkTag 를 사용하여 네트워크에 가상 머신을 포함하지 않으면 호스트는 배치 프로세스에서 별 0을 받습니다.

Type:	String
Aliases:	Tag
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoConnection

가상 네트워크에서 가상 네트워크 어댑터의 연결을 끊습니다.

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

-NoVMNetwork

가상 머신 네트워크가 지정되지 않음을 나타냅니다.

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

-OnBehalfOfUser

사용자 이름을 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 사용자를 대신하여 작동합니다.

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

-OnBehalfOfUserRole

사용자 역할을 지정합니다. 사용자 역할을 가져오려면 Get-SCUserRole cmdlet을 사용합니다. 이 cmdlet은 이 매개 변수가 지정하는 사용자 역할을 대신하여 작동합니다.

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

-PhysicalNetworkAdapterName

실제 네트워크 어댑터의 이름을 지정합니다.

참고

이 매개 변수는 VMM 2019 UR2 이상에 적용할 수 있습니다.

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

-PortACL

포트 ACL 개체를 지정합니다.

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

-PortClassification

가상 네트워크 어댑터가 연결되는 스위치의 포트 분류를 지정합니다.

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

-PROTipID

이 작업을 트리거한 PRO 팁(성능 및 리소스 최적화 팁)의 ID를 지정합니다. 이 매개 변수를 사용하면 PRO 팁을 감사할 수 있습니다.

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

-RunAsynchronously

컨트롤이 명령 셸로 즉시 반환되도록 작업이 비동기적으로 실행됨을 나타냅니다.

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

-Synthetic

Hyper-V 호스트에 배포된 가상 머신의 가상 네트워크 어댑터와 같은 디바이스가 고성능 가상 디바이스임을 지정합니다. 가상 컴퓨터에 가상화 인식 게스트 운영 체제를 설치해야 합니다.

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

-VirtualNetwork

가상 네트워크 개체를 지정합니다.

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

-VLanEnabled

Hyper-V 또는 Citrix XenServer 호스트의 가상 머신에서 사용할 VLAN(가상 LAN)을 사용할지 여부를 나타냅니다.

• 단일 VLAN에 대한 예제 형식: -VLANEnabled -VLANMode "Access" -VLANID 35
• 여러 VLAN에 대한 예제 형식: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

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

-VLanID

1-4094 범위의 숫자 식별자를 가상 머신의 가상 네트워크 어댑터 또는 가상 머신 호스트의 실제 네트워크 어댑터에 할당합니다.

VLan 모드가 Access인 경우 외부에 바인딩된 물리적 네트워크 어댑터의 Hyper-V, VMware ESX 또는 Citrix XenServer 호스트에서 VLanID를 구성합니다.

호스트의 실제 네트워크 어댑터에 바인딩되거나 호스트의 내부 가상 네트워크에 바인딩된 가상 머신의 가상 네트워크 어댑터에서 VLanID를 구성합니다.

예제 형식: -VLanEnabled -VLanMode "Access" -VLANID 35

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

-VM

가상 컴퓨터 개체를 지정합니다.

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

-VMHost

가상 컴퓨터 호스트 개체를 지정합니다. VMM은 Hyper-V 호스트, VMware ESX 호스트 및 Citrix XenServer 호스트를 지원합니다.

각 호스트 유형에 대한 자세한 내용은 Add-SCVMHost cmdlet을 참조하세요.

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

-VMMServer

VMM 서버 개체를 지정합니다.

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

-VMNetwork

가상 머신 네트워크 개체를 지정합니다.

가상 머신 네트워크 개체를 얻으려면 Get-SCVMNetwork cmdlet을 사용합니다.

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

-VMNetworkServiceSetting

가상 머신 네트워크 서비스 설정을 지정합니다.

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

-VMSubnet

가상 머신 서브넷 개체를 지정합니다.

VMSubnet 개체를 가져오려면 Get-SCVMSubnet cmdlet을 사용합니다.

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

-VMTemplate

가상 컴퓨터를 만드는 데 필요한 VMM 템플릿 개체를 지정합니다.

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

-VMwarePortGroup

VMware 포트 그룹을 지정합니다.

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

출력

VirtualNetworkAdapter

이 cmdlet은 VirtualNetworkAdapter 개체를 반환합니다.

참고

• 각각 Get-SCVirtualMachine, Get-SCVMTemplate 및 Get-SCHardwareProfile cmdlet을 사용하여 검색할 수 있는 VMM 가상 머신 개체, 가상 머신 템플릿 개체 또는 하드웨어 프로필 개체가 필요합니다.

관련 링크

• Get-SCHardwareProfile
• Get-SCLogicalNetwork
• Get-SCMACAddressPool
• Get-SCVirtualMachine
• Get-SCVirtualNetwork
• Get-SCVirtualNetworkAdapter
• Get-SCVMTemplate
• Grant-SCMACAddress
• Remove-SCVirtualNetworkAdapter
• Repair-SCVirtualNetworkAdapter
• Set-SCVirtualNetworkAdapter