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 會變更 Virtual Machine Manager （VMM） 環境中所使用的客體作業系統配置檔的一或多個屬性。 對客體作業系統配置檔所做的變更只會影響客體作業系統配置檔本身。 變更不會影響先前使用此配置檔建立的任何現有虛擬機。

範例

範例 1：指定現有客體作業系統配置檔的組織名稱

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

第一個命令會取得名為 NewOSProfile01 的客體 OS 配置檔物件，並將物件儲存在$OSProfile變數中。

第二個命令會將 Contoso 設定為儲存在 $OSProfile 中的客體作業系統配置檔的組織名稱。

範例 2：為現有的 Linux 客體作業系統設定檔指定 SSHKey

謹慎

本文參考 CentOS，這是已達到生命周期結束 （EOL） 狀態的 Linux 發行版。 請據以考慮您的使用和規劃。 如需詳細資訊，請參閱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
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-AutoLogonCount

指定 Windows 應該自動將回應檔案中指定的系統管理員記錄到主控台工作階段的次數。

類型:	UInt32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-AutoLogonCredential

指定當啟用自動系統管理員登入時，Windows 用來登入主控台工作階段的回應檔案中包含的執行身分帳戶。

類型:	RunAsAccount
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ComputerName

指定 VMM 可在網路上唯一識別的電腦名稱。 此參數可接受的值為：

• FQDN
• IPv4 或 IPv6 位址
• NetBIOS 名稱

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DeploymentTypeNano

{{Fill DeploymentTypeNano Description}}

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Description

指定客體作業系統設定檔的描述。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisableAutoLogon

停用自動系統管理員登入。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Domain

指定 Active Directory 網域的完整功能變數名稱 （FQDN）。

範例格式： -Domain "Domain01.Corp.Contoso.com"

類型:	String
別名:	JoinDomain
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-DomainJoinCredential

指定有權將計算機加入網域之帳戶的使用者名稱和密碼。 建議您使用有限的許可權帳戶，將計算機加入網域。 這包括虛擬和實體計算機。

您可以使用目前的 參數，在 VMHostProfile 上指定認證，以便將實體主計算機加入網域，或在新的或現有的範本、新的或現有的客體操作系統配置檔或新的虛擬機上指定認證，以將虛擬機加入網域。

類型:	VMMCredential
別名:	JoinDomainCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DomainJoinOrganizationalUnit

指定自動迷你安裝期間電腦加入的組織單位。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-FullName

指定註冊虛擬機名稱的人員名稱。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-GuestOSProfile

指定客體作業系統配置檔物件。

類型:	GuestOSProfile
Position:	0
預設值:	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
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-JobVariable

指定作業進度會追蹤並儲存在此參數所命名的變數中。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-LinuxAdministratorSSHKey

指定 Linux SSH 金鑰的公鑰檔案。

類型:	SSHKey
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-LinuxAdministratorSSHKeyString

將 Linux 系統管理員 SSH 金鑰指定為字串。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-LinuxDomainName

指定要與Linux作業系統特製化搭配使用的完整功能變數名稱 （FQDN）。

範例格式：-LinuxDomainName "Domain01.Corp.Contoso.com"

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-LocalAdministratorCredential

指定本機系統管理員帳戶的使用者名稱和密碼（或在Linux相容客體作業系統配置檔的情況下為Linux根帳戶）。

在新的或現有的範本、新的或現有的客體作業系統配置檔上指定認證，或在新虛擬機上指定認證會覆寫任何現有的系統管理員密碼。

類型:	VMMCredential
別名:	AdminPasswordCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-MergeAnswerFile

指出這個 Cmdlet 是否將回應檔案與客體作業系統設定合併在一起。 預設值為 $True。 VMM 控制台會使用此參數。 請勿指定此參數。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Name

指定 VMM 物件的名稱。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-OperatingSystem

指定虛擬機的作業系統類型。

若要取得 VMM 中所有可用作業系統的名稱，請輸入 Get-SCOperatingSystem。

類型:	OperatingSystem
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-OrganizationName

指定註冊虛擬機名稱之人員的組織名稱。

類型:	String
別名:	OrgName
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Owner

以有效網域用戶帳戶的形式指定 VMM 對象的擁有者。

• 範例格式：-Owner "Contoso\PattiFuller"
• 範例格式：-Owner "PattiFuller@Contoso"

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ProductKey

指定產品金鑰。 產品金鑰是識別產品授權的 25 位數數位。 產品密鑰可用來註冊 VMM 或要安裝在虛擬機或主機上的作業系統。

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-PROTipID

指定觸發此動作之效能和資源優化提示 （PRO 提示） 的識別碼。 此參數可讓您稽核 PRO 秘訣。

類型:	Guid
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RemoveDomainJoinOrganizationalUnit

指出此 Cmdlet 會移除電腦在安裝期間加入的組織單位。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RemoveServerFeatures

指出此 Cmdlet 會從範本中移除所有伺服器角色和功能。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-RunAsynchronously

表示作業會以異步方式執行，讓控件立即返回命令殼層。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Shielded

指出物件是否受到防護。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-TimeZone

指定數位（索引），識別共用相同標準時間的地理區域。 如需時區索引的清單，請參閱 Microsoft時區索引值。 如果未指定時區，則虛擬機所使用的預設時區是虛擬機主機上的相同時區設定。

指定 GMT 標準時區的範例格式：-TimeZone 085

類型:	Int32
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UnattendSettings

指定由 string String組成的索引鍵/值組。

類型:	System.Collections.Generic.Dictionary`2[System.String,System.String]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UserRole

指定使用者角色物件。

類型:	UserRole
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Workgroup

在新的或現有的範本、新的或現有的客體作業系統配置檔上，或在新的虛擬機上指定您要加入虛擬機的工作組名稱。 您可以使用此參數來覆寫範本或客體作業系統設定檔上的現有值。

類型:	String
別名:	JoinWorkgroup
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸出

GuestOSProfile

此 Cmdlet 會傳回 GuestOSProfile 物件。

備註

• 需要 VMM 客體 OS 設定檔物件，您可以使用 Get-SCGuestOSProfile Cmdlet 來擷取此物件。

相關連結

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