New-SCGuestOSProfile

模組:

VirtualMachineManager

建立客體作業系統設定檔以用於 VMM。

Syntax

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

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

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

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

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

Description

New-SCGuestOSProfile Cmdlet 會建立客體作業系統設定檔，以用於 Virtual Machine Manager (VMM) 。 客體作業系統是虛擬機器上的作業系統，與部署一或多部虛擬機器之實體主機電腦上的主機作業系統相反。

來賓作業系統設定檔會存放作業系統組態資訊。 設定檔包含內容集，其中含有自動回應檔案 (如 Sysprep.inf 或 Unattend.xml 檔案) 中指定的最常用設定。

您可以建立獨立來賓作業系統設定檔，或者自訂範本或虛擬機器以併入來賓作業系統設定檔設定。 New-SCGuestOSProfile Cmdlet 會將新的客體作業系統設定檔物件儲存在 VMM 程式庫中。

您可以根據預設值或現有來賓作業系統來建立來賓作業系統設定檔，也可以在建立來賓作業系統設定檔時自訂該設定檔。 如果您未指定 Name 參數以外的任何參數， New-SCGuestOSProfile Cmdlet 會建立預設客體作業系統設定檔物件。

範例

範例 1：建立預設客體作業系統設定檔

PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Enterprise"}
PS C:\> New-SCGuestOSProfile -Name "NewOSProfile01" -OperatingSystem $OS

第一個命令會從 VMMServer01 取得名為 「64 位版本的 Windows Server 2008 R2 Enterprise」 的作業系統物件，並將物件儲存在 $OS 變數中。

第二個命令會建立名為 NewProfile01 的預設客體作業系統設定檔，並指定作業系統的名稱。

範例 2：建立客體作業系統設定檔，以用來將虛擬機器加入網域

PS C:\> $DomainCredential = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Enterprise"} 
PS C:\> New-SCGuestOSProfile -Name "NewOSProfile02" -JoinDomain "Contoso.com" -DomainJoinCredential $DomainCredential -OperatingSystem $OS

第一個命令會取得名為 RunAsAccount01 的執行身分帳戶物件，並將物件儲存在$DomainCredential變數中。

第二個命令會從 VMMServer01 取得名為 64 位版本的 Windows Server 2008 R2 Enterprise 作業系統物件，並將物件儲存在 $OS 變數中。

最後一個命令會建立名為 NewOSProfile02 的客體作業系統設定檔，並指定作業系統的名稱。 當您使用 NewOSProfile02 建立虛擬機器時，設定檔會使用指定的執行身分帳戶將虛擬機器加入 Contoso.com 網域。

注意：如果您提供 PSCredential 物件，而不是 DomainJoinCredential 參數的 RunAs 帳戶，建議您只使用具有有限許可權的帳戶來自動將虛擬機器加入網域，因為網域帳戶名稱和密碼會在主伺服器上短暫出現純文字。

範例 3：複製現有的客體作業系統設定檔

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile02"
PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.contoso.com" | where {$_.Name -eq "64-bit edition of Windows Server 2008 R2 Datacenter"} 
PS C:\> New-SCGuestOSProfile -Name "NewOSProfile03" -GuestOSProfile $OSProfile -ComputerName "Contoso03" -OperatingSystem $OS

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

第二個命令會取得名為 Windows Server 2008 R2 Datacenter 64 位版本的作業系統物件，並將物件儲存在 $OS 變數中。

最後一個命令會建立名為 NewOSProfile03 的客體作業系統設定檔，此設定檔是以 NewOSProfile02 為基礎，但會修改電腦名稱稱，並指定作業系統的不同名稱。 NewOSProfile03 中的所有其他設定都與 NewOSProfile02 中的設定相同。

範例 4：建立 Linux 客體作業系統設定檔，並設定 Linux DNS 功能變數名稱

PS C:\> $OS = Get-SCOperatingSystem -VMMServer "VMMServer01.Contoso.com" | where {$_.Name -eq "CentOS Linux 6 (64 bit)"} 
PS C:\> New-SCGuestOSProfile -Name "My CentOS Profile" -LinuxDomainName "contoso.com" -OperatingSystem $os

第一個命令會從 VMMServer01 取得名為 CentOS Linux 6 (64 位) 的作業系統物件，並將物件儲存在 $OS 變數中。

第二個命令會建立名為 My CentOS 設定檔的客體作業系統設定檔，並指定作業系統的名稱和 Linux DNS 功能變數名稱。 當您使用 My CentOS 設定檔建立虛擬機器時，設定檔會使用指定的 Linux DNS 功能變數名稱。

參數

-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

表示此 Cmdlet 會停用自動系統管理員登入。

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:	Named
Default value:	None
Required:	False
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:	0
Default value:	None
Required:	True
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 秘訣。

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

-VMMServer

指定 VMM 伺服器物件。

Type:	ServerConnection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
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
• Get-SCOperatingSystem
• Get-SCRunAsAccount
• Remove-SCGuestOSProfile
• Set-SCGuestOSProfile