New-SCGuestOSProfile
建立客體作業系統設定檔以用於 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=120935
Microsoft 時區索引值。
如果未指定時區,則用於虛擬機器的預設時區是虛擬機器主機上的相同時區設定。
指定 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 物件。