Set-SCGuestOSProfile

참조

모듈:: VirtualMachineManager

VMM에서 사용되는 게스트 운영 체제 프로필의 속성을 변경합니다.

구문

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-DomainJoinCredential <VMMCredential>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   -Domain <String>
   [-DeploymentTypeNano <Boolean>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Workgroup <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

Set-SCGuestOSProfile cmdlet은 VMM(Virtual Machine Manager) 환경에서 사용되는 게스트 운영 체제 프로필의 속성을 하나 이상 변경합니다. 게스트 운영 체제 프로필에 대한 변경 내용은 게스트 운영 체제 프로필 자체에만 영향을 미칩니다. 변경 내용은 이 프로필을 사용하여 이전에 만든 기존 가상 머신에 영향을 주지 않습니다.

예제

예제 1: 기존 게스트 운영 체제 프로필의 조직 이름 지정

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile01"
PS C:\> Set-SCGuestOSProfile -GuestOSProfile $OSProfile -OrgName "Contoso"

첫 번째 명령은 NewOSProfile01이라는 게스트 OS 프로필 개체를 가져오고 개체를 $OSProfile 변수에 저장합니다.

두 번째 명령은 Contoso를 $OSProfile 저장된 게스트 운영 체제 프로필의 조직 이름으로 설정합니다.

예제 2: 기존 Linux 게스트 운영 체제 프로필에 대한 SSHKey 지정

주의

이 문서에서는 EOL(수명 종료) 상태에 도달한 Linux 배포판인 CentOS를 참조합니다. 그에 따라 사용 및 계획을 고려하세요. 자세한 내용은 CentOS 수명 종료 지침참조하세요.

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "My CentOS Profile"
PS C:\> $Sshkey = Get-SCSSHKey -Name "My.Sshkey"
PS C:\> Set-SCGuestOSProfile -GuestOSProfile $OSProfile -LinuxAdministratorSSHKey $Sshkey

첫 번째 명령은 MyCentOSProfile이라는 게스트 OS 프로필 개체를 가져오고 개체를 $OSProfile 변수에 저장합니다.

두 번째 명령은 My.Sshkey라는 SSHKey 개체를 가져오고 개체를 $Sshkey 변수에 저장합니다.

마지막 명령은 $OSProfile 저장된 게스트 운영 체제 프로필에서 My.sshkey 개체를 설정합니다.

매개 변수

-AnswerFile

응답 파일로 사용할 VMM 라이브러리에 저장된 스크립트 개체를 지정합니다. 응답 파일 스크립트의 이름은 가상 머신에 설치하려는 운영 체제에 따라 달라집니다.

Sysprep.inf. Windows XP, Windows Server 2000 또는 Windows Server 2003
Unattend.xml. Windows Vista, Windows 7 또는 Windows Server 2008

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

-AutoLogonCount

Windows에서 응답 파일에 지정된 관리자를 콘솔 세션에 자동으로 로그하는 횟수를 지정합니다.

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

-AutoLogonCredential

자동 관리자 로그온을 사용할 때 Windows에서 콘솔 세션에 로그온하는 데 사용하는 응답 파일에 포함된 실행 계정을 지정합니다.

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

-ComputerName

VMM이 네트워크에서 고유하게 식별할 수 있는 컴퓨터의 이름을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

FQDN
IPv4 또는 IPv6 주소
NetBIOS 이름

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

-DeploymentTypeNano

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

-Description

게스트 운영 체제 프로필에 대한 설명을 지정합니다.

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

-DisableAutoLogon

자동 관리자 로그온을 사용하지 않도록 설정합니다.

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

-Domain

Active Directory 도메인의 FQDN(정규화된 도메인 이름)을 지정합니다.

예제 형식: -Domain "Domain01.Corp.Contoso.com"

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

-DomainJoinCredential

컴퓨터를 도메인에 가입할 수 있는 권한이 있는 계정의 사용자 이름과 암호를 지정합니다. 도메인에 컴퓨터를 조인하는 제한된 권한 계정을 사용하는 것이 좋습니다. 여기에는 가상 컴퓨터와 물리적 컴퓨터가 모두 포함됩니다.

현재 매개 변수를 사용하여 실제 호스트 컴퓨터를 도메인에 조인하기 위한 VMHostProfile 자격 증명을 지정하거나, 새 템플릿 또는 기존 템플릿, 새 또는 기존 게스트 운영 체제 프로필 또는 새 가상 머신에서 가상 머신을 도메인에 조인하기 위한 자격 증명을 지정할 수 있습니다.

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

-DomainJoinOrganizationalUnit

무인 미니 설치 중에 컴퓨터가 조인되는 조직 구성 단위를 지정합니다.

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

-FullName

가상 머신이 등록된 이름을 가진 사람의 이름을 지정합니다.

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

-GuestOSProfile

게스트 운영 체제 프로필 개체를 지정합니다.

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

-GuiRunOnceCommands

무인 응답 파일의 [GuiRunOnce] 섹션에 추가할 명령 배열을 지정합니다. 큰따옴표로 묶인 각 문자열 주위에 작은따옴표를 사용합니다.

예제 형식: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

Windows PowerShell에서 따옴표를 사용하는 방법에 대한 자세한 내용은 Get-Help about_Quoting_Rules입력합니다.

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

-JobVariable

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

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

-LinuxAdministratorSSHKey

Linux SSH 키에 대한 공개 키 파일을 지정합니다.

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

-LinuxAdministratorSSHKeyString

Linux 관리자 SSH 키를 문자열로 지정합니다.

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

-LinuxDomainName

Linux 운영 체제 전문화와 함께 사용할 FQDN(정규화된 도메인 이름)을 지정합니다.

예제 형식: -LinuxDomainName "Domain01.Corp.Contoso.com"

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

-LocalAdministratorCredential

로컬 관리자 계정(또는 Linux 호환 게스트 운영 체제 프로필의 경우 Linux 루트 계정)의 사용자 이름 및 암호를 지정합니다.

새 템플릿 또는 기존 템플릿, 새 또는 기존 게스트 운영 체제 프로필 또는 새 가상 머신에서 자격 증명을 지정하면 기존 관리자 암호가 재정의됩니다.

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

-MergeAnswerFile

이 cmdlet이 응답 파일을 게스트 운영 체제 설정과 병합하는지 여부를 나타냅니다. 기본값은 $True. VMM 콘솔은 이 매개 변수를 사용합니다. 이 매개 변수를 지정하지 마세요.

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

-OrganizationName

가상 머신이 등록된 이름을 가진 사람의 조직 이름을 지정합니다.

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

-RemoveDomainJoinOrganizationalUnit

이 cmdlet은 설치 중에 컴퓨터가 조인한 조직 구성 단위를 제거한다는 것을 나타냅니다.

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

-RemoveServerFeatures

이 cmdlet은 템플릿에서 모든 서버 역할 및 기능을 제거한다는 것을 나타냅니다.

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

-RunAsynchronously

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

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

-Shielded

개체가 보호되는지 여부를 나타냅니다.

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

-TimeZone

동일한 표준 시간을 공유하는 지리적 지역을 식별하는 숫자(인덱스)를 지정합니다. 표준 시간대 인덱스 목록은 microsoft 표준 시간대 인덱스 값 참조하세요. 표준 시간대가 지정되지 않은 경우 가상 머신에 사용되는 기본 표준 시간대는 가상 머신 호스트에 있는 동일한 표준 시간대 설정입니다.

GMT 표준 시간대를 지정하는 예제 형식: -TimeZone 085

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

-UnattendSettings

String, String구성된 키/값 쌍을 지정합니다.

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

-UserRole

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

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

-Workgroup

새 템플릿 또는 기존 템플릿, 새 또는 기존 게스트 운영 체제 프로필 또는 새 가상 머신에서 가상 머신에 가입할 작업 그룹의 이름을 지정합니다. 이 매개 변수를 사용하여 템플릿 또는 게스트 운영 체제 프로필의 기존 값을 재정의할 수 있습니다.

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

출력

GuestOSProfile

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

참고

Get-SCGuestOSProfile cmdlet을 사용하여 검색할 수 있는 VMM 게스트 OS 프로필 개체가 필요합니다.

다음을 통해 공유