Get-SCVirtualHardDisk

모듈:

VirtualMachineManager

가상 머신, 템플릿 또는 VMM 라이브러리에 저장된 독립 실행형 파일로 가상 하드 디스크 개체를 가져옵니다.

Syntax

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   -VMTemplate <Template>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   -VM <VM>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   -Name <String>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-Release <String>]
   -FamilyName <String>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

Get-SCVirtualHardDisk cmdlet은 가상 머신, 템플릿 또는 VMM(Virtual Machine Manager) 라이브러리에 저장된 독립 실행형 파일로 가상 하드 디스크 개체를 가져옵니다.

가상 하드 디스크는 Windows 기반 .vhd 파일, Citrix XenServer 기반 .vhd 파일 또는 VMware 기반.vmdk 파일일 수 있습니다. 가상 하드 디스크는 VMM 라이브러리에 독립 실행형 개체로 저장되거나, 템플릿의 가상 디스크 드라이브에 연결되거나, 배포되거나 저장된 가상 머신의 가상 디스크 드라이브에 연결될 수 있습니다.

예제

예제 1: 라이브러리에서 가상 하드 디스크 개체 가져오기

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "VHD01.vhd" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }

이 명령은 LibraryServer01에 저장된 VHD01.vhd라는 가상 하드 디스크 개체를 가져온 다음 개체를 $VHD 변수에 저장합니다.

예제 2: 가상 머신에서 가상 하드 디스크 개체 가져오기

PS C:\> Get-SCVMMServer -ComputerName "VMMServer01.Contoso.com"
PS C:\> $VHD = Get-SCVirtualMachine -Name "VM01" | Get-SCVirtualHardDisk | where { $_.Name -match "DataDisk" }

첫 번째 명령은 VMMServer01에 연결됩니다.

두 번째 명령은 VM01이라는 가상 머신 개체를 가져오고 이름에 "DataDisk" 문자열이 포함된 VM01의 모든 가상 하드 디스크를 선택한 다음 반환된 가상 하드 디스크 개체를 $VHD 변수에 저장합니다.

예제 3: 특정 템플릿에서 가상 하드 디스크 개체 가져오기

PS C:\> Get-SCVMTemplate -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "Template01"} | Get-SCVirtualHardDisk

이 명령은 라이브러리에서 Template01이라는 템플릿 개체를 가져오고 해당 템플릿의 모든 가상 하드 디스크 개체를 표시합니다.

매개 변수

-All

이 cmdlet은 부모 개체와 독립적인 모든 하위 개체를 가져옵니다. 예를 들어 이 명령은 Get-SCVirtualDiskDrive -All 각 가상 디스크 드라이브 개체가 연결된 가상 머신 개체 또는 템플릿 개체에 관계없이 모든 가상 디스크 드라이브 개체를 가져옵니다.

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

-FamilyName

VMM 라이브러리의 물리적 리소스에 대한 패밀리 이름을 지정합니다. 이 값은 릴리스, 네임스페이스 및 형식과 함께 라이브러리 리소스 간에 동등성을 설정하는 데 사용됩니다.

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

-ID

숫자 식별자를 특정 개체에 대해 전역적으로 고유한 식별자 또는 GUID로 지정합니다.

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

-Name

VMM 개체의 이름을 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	True
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

-Release

라이브러리 리소스의 릴리스를 설명하는 문자열을 지정합니다. VMM은 라이브러리로 가져온 모든 리소스에 대한 릴리스 값을 자동으로 만듭니다. 리소스를 가져온 후 문자열을 사용자 지정할 수 있습니다.

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

-VMMServer

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

Type:	ServerConnection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
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

출력

VirtualHardDisk

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

참고

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

관련 링크

• Compress-SCVirtualDiskDrive
• Get-SCVirtualDiskDrive
• Get-SCVirtualMachine
• Get-SCVMTemplate
• Remove-SCVirtualHardDisk
• Set-SCVirtualDiskDrive
• Set-SCVirtualHardDisk