다음을 통해 공유


Set-SCVirtualHardDisk

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

구문

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 파일입니다.

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

  • 묘사
  • 사용
  • 이름
  • 운영 체제
  • 소유자
  • 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

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

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Enabled

$True 설정할 때 개체를 사용하거나 $False 설정하면 개체를 사용하지 않도록 설정합니다. 예를 들어 가상 머신 템플릿에서 소프트웨어를 업그레이드하려는 경우 VMM 라이브러리에서 템플릿 개체를 사용하지 않도록 설정하여 사용자가 해당 개체를 일시적으로 사용하지 않도록 설정할 수 있습니다.

형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-FamilyName

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

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-JobGroup

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

형식:Guid
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-JobVariable

작업 진행률이 추적되고 이 매개 변수로 명명된 변수에 저장되도록 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Name

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

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-OperatingSystem

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

형식:OperatingSystem
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Owner

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

  • 예제 형식: -Owner "Contoso\PattiFuller"
  • 예제 형식: -Owner "PattiFuller@Contoso"
형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ProductKey

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

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PROTipID

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

형식:Guid
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Release

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

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RunAsynchronously

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

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SharePath

UNC(유니버설 명명 규칙) 경로를 사용하는 기존 라이브러리 서버에서 유효한 라이브러리 공유의 경로를 지정합니다.

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

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Tag

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

형식:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-UserRole

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

형식:UserRole
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-VirtualHardDisk

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

형식:VirtualHardDisk
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-VirtualHardDisks

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

형식:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-VirtualizationPlatform

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

  • HyperV
  • VMwareESX
  • XENServer
형식:VirtualizationPlatform
허용되는 값:Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-VMMServer

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

형식:ServerConnection
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

출력

VirtualHardDisk

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

참고

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