다음을 통해 공유


Set-SCVMConfiguration

컴퓨터 계층에 대한 가상 머신 구성을 수정합니다.

구문

Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMMServer <ServerConnection>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   -VMHost <Host>
   [-PinVMHost <Boolean>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   [-VMHostGroup <HostGroup>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMMServer <ServerConnection>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   -Cloud <Cloud>
   [-CapabilityProfile <CapabilityProfile>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

Set-SCVMConfiguration cmdlet은 컴퓨터 계층에 대한 가상 머신 구성을 수정합니다. 가상 머신 구성은 서비스가 배포될 때 가상 머신을 구성하는 방법을 설명합니다.

예제

예제 1: 서비스를 배포하기 전에 머신 계층에 대한 가상 머신 구성 업데이트

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[0] -Description "This is the updated virtual machine configuration"

첫 번째 명령은 Service01이라는 서비스 구성 개체를 가져오고 개체를 $ServiceConfig 변수에 저장합니다.

두 번째 명령은 $ServiceConfig 저장된 서비스 구성에 대한 컴퓨터 계층 구성을 가져오고 개체를 $TierConfig 변수에 저장합니다.

세 번째 명령은 $TierConfig 저장된 컴퓨터 계층 구성에 대한 가상 머신 구성을 가져오고 변수를 $VMConfig 변수에 저장합니다.

마지막 명령은 $VMConfig 저장된 첫 번째 가상 머신 구성 개체의 설명 속성을 설정하고 사용자에게 가상 머신 구성의 속성을 표시합니다.

예제 2: 가상 머신에 대한 호스트를 고정하도록 컴퓨터 계층에 대한 가상 머신 구성 개체 구성

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01" 
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig 
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[0] -PinVMHost $True

첫 번째 명령은 Service01이라는 서비스 구성 개체를 가져오고 개체를 $ServiceConfig 변수에 저장합니다.

두 번째 명령은 $ServiceConfig 저장된 서비스 구성에 대한 컴퓨터 계층 구성 개체를 가져오고 개체를 $TierConfig 변수에 저장합니다.

세 번째 명령은 $TierConfig 저장된 컴퓨터 계층 구성에 대한 가상 머신 구성 개체를 가져오고 개체를 $VMConfig 변수에 저장합니다.

마지막 명령은 $VMConfig 저장된 첫 번째 가상 머신 구성 개체에 대해 PinVMHost 전파를 $True 설정합니다. 따라서 서비스를 배포할 때 이 구성으로 만든 가상 머신의 호스트는 변경되지 않습니다.

예제 3: 프라이빗 클라우드의 서비스에 대한 가상 머신 구성 개체 구성

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig 
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> $Cloud = Get-SCCloud -Name "Production"
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[1] -Cloud $Cloud -Description "This is the new virtual machine configuration"

첫 번째 명령은 Service01이라는 서비스 구성 개체를 가져오고 개체를 $ServiceConfig 변수에 저장합니다.

두 번째 명령은 $ServiceConfig 저장된 서비스 구성에 대한 컴퓨터 계층 구성을 가져오고 개체를 $TierConfig 변수에 저장합니다.

세 번째 명령은 $TierConfig 저장된 컴퓨터 계층 구성에 대한 가상 머신 구성 개체를 가져오고 개체를 $VMConfig 변수에 저장합니다.

네 번째 명령은 Production이라는 프라이빗 클라우드 개체를 가져오고 개체를 $Cloud 변수에 저장합니다.

마지막 명령은 $Cloud 저장된 프라이빗 클라우드에 대해 $VMConfig 저장된 두 번째 가상 머신 구성 개체에 대한 설명을 업데이트합니다.

매개 변수

-AvailabilitySetNames

가용성 집합 이름 목록을 지정합니다.

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

-CapabilityProfile

기능 프로필 개체를 지정합니다.

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

-Cloud

프라이빗 클라우드 개체를 지정합니다.

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

-ComputerName

VMM(Virtual Machine Manager)이 네트워크에서 고유하게 식별할 수 있는 컴퓨터의 이름을 지정합니다. 유효한 형식은 다음과 같습니다.

  • FQDN
  • IPv4 또는 IPv6 주소
  • NetBIOS 이름
형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-CostCenter

청구 시스템에서 사용할 가상 머신(또는 가상 머신에 할당된 리소스)의 할당에 대한 데이터를 수집할 수 있도록 가상 머신의 비용 센터를 지정합니다.

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

-Description

구성에 대한 설명을 지정합니다.

형식:String
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

-NoConnectedHost

가상 머신 구성에서 호스트를 제거합니다.

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

-OnBehalfOfUser

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

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

-OnBehalfOfUserRole

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

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

-PinVMHost

사용자가 선택한 가상 머신 호스트가 서비스 배포 구성 중에 유지되는지 여부를 나타냅니다.

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

-PinVMLocation

사용자가 선택한 가상 머신 위치가 서비스 배포 구성 중에 유지되는지 여부를 나타냅니다.

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

-PROTipID

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

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

-RunAsynchronously

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

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

-Tag

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

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

-VMConfiguration

가상 머신 구성 개체를 지정합니다.

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

-VMHost

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

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

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

-VMHostGroup

가상 머신 호스트 그룹 개체 또는 호스트 그룹 개체의 배열을 지정합니다.

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

-VMLocation

가상 머신의 경로를 지정합니다.

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

-VMMServer

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

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

출력

VMConfiguration

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