Get-SCVirtualNetworkAdapter
가상 머신, 가상 머신 템플릿 또는 하드웨어 프로필에서 VMM 가상 네트워크 어댑터 개체를 가져옵니다.
구문
Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
[-All]
[-ParentTypeVMOrHost]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
-HardwareProfile <HardwareProfile>
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
-VM <VM>
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
-VMTemplate <Template>
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
-VMHost <Host>
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Get-SCVirtualNetworkAdapter
[-VMMServer <ServerConnection>]
[-ID] <Guid>
[[-Name] <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Description
Get-SCVirtualNetworkAdapter cmdlet은 가상 머신 개체, 가상 머신 템플릿 개체 또는 VMM(Virtual Machine Manager) 환경의 하드웨어 프로필 개체에서 하나 이상의 가상 네트워크 어댑터 개체를 가져옵니다.
예제
예제 1: 가상 머신에서 가상 네트워크 어댑터 가져오기
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualNetworkAdapter -VM $VM첫 번째 명령은 VM01이라는 가상 머신 개체를 가져오고 개체를 $VM 변수에 저장합니다.
두 번째 명령은 VM01의 모든 가상 네트워크 어댑터 개체를 가져오고 어댑터에 대한 정보를 사용자에게 표시합니다.
예제 2: 가상 머신 템플릿에서 가상 네트워크 어댑터 가져오기
PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> Get-SCVirtualNetworkAdapter -Template $VMTemplate첫 번째 명령은 VMM 라이브러리에서 모든 가상 머신 템플릿 개체를 가져오고, VMTemplate01이라는 템플릿 개체를 선택하고, 개체를 $VMTemplate 변수에 저장합니다.
마지막 명령은 모든 가상 네트워크 어댑터 개체 VMTemplate01을 가져오고 이러한 어댑터에 대한 정보를 사용자에게 표시합니다.
예제 3: 하드웨어 프로필에서 가상 네트워크 어댑터 가져오기
PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Get-SCVirtualNetworkAdapter -HardwareProfile $HWProfile첫 번째 명령은 VMM 라이브러리의 모든 하드웨어 프로필 개체를 가져오고 NewHWProfile01이라는 프로필 개체를 선택한 다음 개체를 $HWProfile 변수에 저장합니다.
두 번째 명령은 모든 가상 네트워크 어댑터 개체 NewHWProfile01을 가져오고 이러한 어댑터에 대한 정보를 사용자에게 표시합니다.
매개 변수
-All
이 cmdlet은 부모 개체와 독립적으로 모든 하위 개체를 가져옵니다.
예를 들어 명령 Get-SCVirtualDiskDrive -All 각 가상 디스크 드라이브 개체가 연결된 가상 머신 개체 또는 템플릿 개체에 관계없이 모든 가상 디스크 드라이브 개체를 가져옵니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-HardwareProfile
하드웨어 프로필 개체를 지정합니다.
| 형식: | HardwareProfile |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ID
숫자 식별자를 특정 개체에 대해 전역적으로 고유한 식별자 또는 GUID로 지정합니다.
| 형식: | Guid |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-Name
네트워크 개체의 이름을 지정합니다.
| 형식: | String |
| Position: | 1 |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-OnBehalfOfUser
사용자 이름을 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 사용자를 대신하여 작동합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-OnBehalfOfUserRole
사용자 역할을 지정합니다. 사용자 역할을 가져오려면 Get-SCUserRole cmdlet을 사용합니다. 이 cmdlet은 이 매개 변수가 지정하는 사용자 역할을 대신하여 작동합니다.
| 형식: | UserRole |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ParentTypeVMOrHost
부모 형식이 가상 머신 또는 호스트임을 나타냅니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-VM
가상 머신 개체를 지정합니다.
| 형식: | VM |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-VMHost
가상 머신 호스트 개체를 지정합니다. VMM은 Hyper-V 호스트, VMware ESX 호스트 및 Citrix XenServer 호스트를 지원합니다.
각 호스트 유형에 대한 자세한 내용은 Add-SCVMHost cmdlet을 참조하세요.
| 형식: | Host |
| 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 |
출력
VirtualNetworkAdapter
이 cmdlet은 VirtualNetworkAdapter 개체를 반환합니다.
참고
- Get-SCVirtualMachine, get-SCVMTemplate
또는 Get-SCHardwareProfile cmdlet을 각각 사용하여 검색할 수 있는 VMM 가상 머신 개체, 가상 머신 템플릿 개체 또는 하드웨어 프로필 개체가 필요합니다.