Set-SCGuestOSProfile

모듈:

VirtualMachineManager

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

Syntax

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 지정

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

Type:	Script
Aliases:	SysPrepFile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-AutoLogonCount

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

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

-AutoLogonCredential

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

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

-ComputerName

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

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

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

-DeploymentTypeNano

{{DeploymentTypeNano 설명 채우기}}

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

-DisableAutoLogon

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

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

-Domain

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

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

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

-DomainJoinCredential

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

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

Type:	VMMCredential
Aliases:	JoinDomainCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DomainJoinOrganizationalUnit

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

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

-FullName

가상 컴퓨터가 등록된 사용자의 이름을 지정합니다.

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

-GuestOSProfile

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

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

-GuiRunOnceCommands

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

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

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

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

-LinuxAdministratorSSHKey

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

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

-LinuxAdministratorSSHKeyString

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

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

-LinuxDomainName

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

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

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

-LocalAdministratorCredential

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

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

Type:	VMMCredential
Aliases:	AdminPasswordCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MergeAnswerFile

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

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

-OperatingSystem

가상 컴퓨터의 운영 체제 유형을 지정합니다.

VMM에서 사용 가능한 모든 운영 체제의 이름을 얻으려면 .를 입력합니다 Get-SCOperatingSystem.

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

-OrganizationName

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

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

-Owner

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

• 예제 형식: -Owner "Contoso\PattiFuller"
• 예제 형식: -Owner "PattiFuller@Contoso"

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

-ProductKey

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

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

-RemoveDomainJoinOrganizationalUnit

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

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

-RemoveServerFeatures

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

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

-Shielded

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

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

-TimeZone

동일한 표준 시간을 공유하는 지리적 지역을 식별하는 숫자(인덱스)를 지정합니다. 표준 시간대 인덱스 목록은 Microsoft 표준 시간대 인덱스 값을 참조하세요http://go.microsoft.com/fwlink/?LinkId=120935. 표준 시간대를 지정하지 않으면 가상 머신에 사용되는 기본 표준 시간대는 가상 머신 호스트에 있는 표준 시간대 설정과 동일합니다.

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

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

-UnattendSettings

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

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

-UserRole

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

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

-Workgroup

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

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

출력

GuestOSProfile

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

참고

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

관련 링크

• Get-SCGuestOSProfile
• New-SCGuestOSProfile
• Remove-SCGuestOSProfile