Set-SCGuestOSProfile
變更 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=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 |
-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 來擷取。