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 개체를 반환합니다.