Set-SCVMConfiguration

모듈:

VirtualMachineManager

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

Syntax

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

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

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

-CapabilityProfile

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

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

-Cloud

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

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

-ComputerName

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

• FQDN
• IPv4 또는 IPv6 주소
• NetBIOS 이름

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

-CostCenter

가상 컴퓨터 할당 또는 가상 컴퓨터에 할당된 리소스와 관련된 데이터를 수집하여 비용 시스템에서 사용할 수 있도록 가상 컴퓨터의 비용 센터를 지정합니다.

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

-Description

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

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

-NoConnectedHost

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

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

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

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

-PinVMHost

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

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

-PinVMLocation

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

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

-RunAsynchronously

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

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

-Tag

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

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

-VMConfiguration

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

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

-VMHost

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

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

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

-VMHostGroup

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

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

-VMLocation

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

Type:	String
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:	False
Accept wildcard characters:	False

출력

VMConfiguration

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

관련 링크

• Get-SCComputerTierConfiguration
• Get-SCServiceConfiguration
• Get-SCVMConfiguration
• New-SCVMConfiguration
• Remove-SCVMConfiguration
• Update-SCVMConfiguration