Set-SCVirtualHardDisk

모듈:

VirtualMachineManager

VMM에 사용되는 가상 하드 디스크 개체의 속성을 변경합니다.

Syntax

Set-SCVirtualHardDisk
   [-OperatingSystem <OperatingSystem>]
   [-VirtualizationPlatform <VirtualizationPlatform>]
   [-Tag <System.Collections.Generic.List`1[System.String]>]
   [-ProductKey <String>]
   [-UserRole <UserRole>]
   [-Enabled <Boolean>]
   [-VMMServer <ServerConnection>]
   [-VirtualHardDisk] <VirtualHardDisk>
   [-JobGroup <Guid>]
   [-Name <String>]
   [-SharePath <String>]
   [-Description <String>]
   [-Owner <String>]
   [-FamilyName <String>]
   [-Release <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCVirtualHardDisk
   [-VMMServer <ServerConnection>]
   [-VirtualHardDisks] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]>
   -FamilyName <String>
   -Release <String>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

Set-SCVirtualHardDisk cmdlet은 VMM(Virtual Machine Manager) 환경에서 사용되는 가상 하드 디스크 개체의 속성을 하나 이상 변경합니다. VMM에서 사용되는 가상 하드 디스크 파일은 Windows 기반 .vhd 파일, Citrix XenServer 기반 .vhd 파일 또는 VMware 기반 .vmdk 파일입니다.

변경할 수 있는 속성의 예는 다음과 같습니다.

• 설명
• 사용
• Name
• 운영 체제
• 소유자
• SharePath

가상 하드 디스크 파일은 VMM 라이브러리에 보관하거나 가상 컴퓨터 또는 템플릿의 가상 디스크 드라이브에 연결할 수 있습니다.

가상 디스크 드라이브에 대한 버스 및 LUN 설정을 변경하려면 Set-SCVirtualDiskDrive cmdlet을 사용합니다.

예제

예제 1: 가상 하드 디스크에 대한 설명 변경

PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "WindowsServer2008R2BootVHD.vhd"}
PS C:\> Set-SCVirtualHardDisk -VirtualHardDisk $VHD -Description "Latest Windows Server 2008 R2 Boot VHD"

첫 번째 명령은 VMMServer01의 라이브러리에서 "WindowsServer2003BootVHD.vhd"라는 가상 하드 디스크 개체를 검색한 다음 개체를 $VHD 변수에 저장합니다.

두 번째 명령은 $VHD 저장된 가상 하드 디스크 개체에 대한 설명을 "최신 Windows Server 2008 R2 부팅 VHD"로 변경합니다.

예제 2: 라이브러리에서 VMware 기반 가상 하드 디스크 사용

PS C:\> $VMDK = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "WindowsServer2008.vmdk"}
PS C:\> Set-SCVirtualHardDisk -VirtualHardDisk $VMDK -Enabled $FALSE

첫 번째 명령은 WindowsServer2008.vmdk라는 가상 하드 디스크 개체를 가져온 다음 가상 하드 디스크 개체를 $VMDK 변수에 저장합니다.

두 번째 명령은 $VMDK 저장된 가상 하드 디스크 개체를 사용하지 않도록 설정합니다.

예제 3: "알 수 없음" 소유자가 있는 모든 가상 하드 디스크의 소유자 지정

PS C:\> Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-SCVirtualHardDisk -Owner "Contoso\ReneeLo"

이 명령은 소유자가 "알 수 없음"인 VMM 라이브러리에서 모든 가상 하드 디스크 개체를 가져온 다음 각 가상 하드 디스크 개체의 소유자를 지정합니다.

매개 변수

-Description

가상 하드 디스크 개체에 대한 설명을 지정합니다.

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

-Enabled

$True 설정할 때 개체를 사용하거나 $False 설정하면 개체를 사용하지 않도록 설정합니다. 예를 들어 가상 컴퓨터 템플릿의 소프트웨어를 업그레이드하려는 경우 VMM 라이브러리에서 템플릿 개체를 사용하지 않도록 설정하면 업그레이드하는 동안 사용자가 해당 개체를 사용하지 못하도록 할 수 있습니다.

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

-JobGroup

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

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

-Name

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

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

-OperatingSystem

가상 컴퓨터의 운영 체제 유형을 지정합니다. VMM에서 사용 가능한 모든 운영 체제의 이름을 나열하려면 다음을 입력합니다 Get-SCOperatingSystem.

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

-Owner

유효한 도메인 사용자 계정의 형태로 VMM 개체의 소유자를 지정합니다.

• 예제 형식: -Owner "Contoso\PattiFuller"
• 예제 형식: -Owner "PattiFuller@Contoso"

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

-ProductKey

제품 키를 지정합니다. 제품 키는 제품 라이선스를 식별하는 25자리 숫자입니다. 제품 키를 사용하여 가상 머신 또는 호스트에 설치할 VMM 또는 운영 체제를 등록할 수 있습니다.

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

-Release

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

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

-SharePath

UNC(Universal Naming Convention) 경로를 사용하는 기존 라이브러리 서버의 유효한 라이브러리 서버 경로를 지정합니다.

예제 형식: -SharePath "\\LibServer01\LibShare"

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

-Tag

지정된 태그 집합이 있는 모든 개체를 검색할 수 있도록 개체와 연결할 단어 또는 구를 지정합니다. 태그의 하위 집합을 검색하거나 전체 태그 집합을 검색할 수 있습니다.

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserRole

사용자 역할 개체를 지정합니다.

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

-VirtualHardDisk

가상 하드 디스크 개체를 지정합니다.

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

-VirtualHardDisks

가상 하드 디스크 개체의 배열을 지정합니다.

Type:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VirtualizationPlatform

VMM을 통해 관리되는 가상 컴퓨터 호스트의 가상화 플랫폼을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

• HyperV
• VMwareESX
• Xenserver

Type:	VirtualizationPlatform
Accepted values:	Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMMServer

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

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

출력

VirtualHardDisk

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

참고

• Get-SCVirtualHardDisk cmdlet을 사용하여 검색할 수 있는 VMM 가상 하드 디스크 개체가 필요합니다.

관련 링크

• Compress-SCVirtualDiskDrive
• Convert-SCVirtualDiskDrive
• Expand-SCVirtualDiskDrive
• Get-SCVirtualDiskDrive
• Get-SCVirtualHardDisk
• Move-SCVirtualHardDisk
• New-SCVirtualDiskDrive
• Remove-SCVirtualDiskDrive
• Remove-SCVirtualHardDisk
• Set-SCVirtualDiskDrive