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 會變更 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

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

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

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

{{Fill DeploymentTypeNano Description}}

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 提示 (PRO 提示的識別碼) 。 此參數可讓您稽核 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

指定 (索引) 的數位，以識別共用相同標準時間的地理區域。 如需時區索引的清單，請參閱 位於 的 http://go.microsoft.com/fwlink/?LinkId=120935Microsoft 時區索引值。 如果未指定時區，則用於虛擬機器的預設時區是虛擬機器主機上的相同時區設定。

指定 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 物件。

備註

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

相關連結

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