Set-SCVirtualHardDisk
變更 VMM 中使用的虛擬硬碟物件屬性。
語法
Set-SCVirtualHardDisk
[-OperatingSystem <OperatingSystem>]
[-VirtualizationPlatform <VirtualizationPlatform>]
[-Tag <System.Collections.Generic.List`1[System.String]>]
[-ProductKey <String>]
[-UserRole <UserRole>]
[-Enabled <Boolean>]
[-VMMServer <ServerConnection>]
[-VirtualHardDisk] <VirtualHardDisk>
[-JobGroup <Guid>]
[-Name <String>]
[-SharePath <String>]
[-Description <String>]
[-Owner <String>]
[-FamilyName <String>]
[-Release <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Set-SCVirtualHardDisk
[-VMMServer <ServerConnection>]
[-VirtualHardDisks] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]>
-FamilyName <String>
-Release <String>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Description
Set-SCVirtualHardDisk Cmdlet 會變更 Virtual Machine Manager (VMM) 環境中所使用的虛擬硬碟物件的一或多個屬性。 VMM 中使用的虛擬硬碟檔案是 Windows 型 .vhd 檔案、Citrix XenServer 型 .vhd 檔案或 VMware 型 .vmdk 檔案。
您可以變更的屬性包括:
- 描述
- 啟用
- 名字
- 操作系統
- 擁有者
- SharePath
虛擬硬碟檔案可能會儲存在 VMM 連結庫中,或可能連結至虛擬機或範本上的虛擬磁碟驅動器。
若要變更虛擬磁碟驅動器的總線和 LUN 設定,請使用 Set-SCVirtualDiskDrive Cmdlet。
範例
範例 1:變更虛擬硬碟的描述
PS C:\> $VHD = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "WindowsServer2008R2BootVHD.vhd"}
PS C:\> Set-SCVirtualHardDisk -VirtualHardDisk $VHD -Description "Latest Windows Server 2008 R2 Boot VHD"
第一個命令會從 VMMServer01 上的連結庫擷取名為 「WindowsServer2003BootVHD.vhd」 的虛擬硬碟物件,然後將物件儲存在 $VHD 變數中。
第二個命令會將儲存在 $VHD 中的虛擬硬碟物件描述變更為「最新的 Windows Server 2008 R2 開機 VHD」。
範例 2:在連結庫中啟用以 VMware 為基礎的虛擬硬碟
PS C:\> $VMDK = Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "WindowsServer2008.vmdk"}
PS C:\> Set-SCVirtualHardDisk -VirtualHardDisk $VMDK -Enabled $FALSE
第一個命令會取得名為 WindowsServer2008.vmdk 的虛擬硬碟物件,然後將虛擬硬碟物件儲存在$VMDK變數中。
第二個命令會停用儲存在 $VMDK 中的虛擬硬碟物件。
範例 3:為具有「未知」擁有者的所有虛擬硬碟指定擁有者
PS C:\> Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-SCVirtualHardDisk -Owner "Contoso\ReneeLo"
此命令會從擁有者為 「未知」的 VMM 連結庫取得所有虛擬硬碟物件,然後指定每個虛擬硬碟物件的擁有者。
參數
-Description
指定虛擬硬碟物件的描述。
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Enabled
當設定為 $True 時啟用 物件,或在設定為 $False 時停用物件。 例如,如果您想要升級虛擬機範本上的軟體,您可以停用 VMM 連結庫中的範本物件,暫時防止使用者使用該物件。
類型: | Boolean |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-FamilyName
指定 VMM 連結庫中實體資源的系列名稱。 此值會與 Release、Namespace 和 Type 搭配使用,以在連結庫資源之間建立等價。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-JobGroup
指定一系列命令的標識碼,這些命令將在包含相同作業群組標識符的執行的最後一個命令之前,以集合的形式執行。
類型: | Guid |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-JobVariable
指定作業進度會追蹤並儲存在此參數所命名的變數中。
類型: | String |
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 |
-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 |
-Release
指定描述連結庫資源發行的字串。 VMM 會自動為匯入連結庫的每個資源建立發行值。 匯入資源之後,即可自定義字串。
類型: | String |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-RunAsynchronously
表示作業會以異步方式執行,讓控件立即返回命令殼層。
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-SharePath
指定現有連結庫伺服器上使用通用命名約定 (UNC) 路徑的有效連結庫共享路徑。
範例格式: -SharePath "\\LibServer01\LibShare"
類型: | String |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-Tag
指定要與 物件建立關聯的單字或片語,以便搜尋具有指定標記集的所有物件。 您可以搜尋標記的子集,也可以搜尋完整的標記集。
類型: | System.Collections.Generic.List`1[System.String] |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-UserRole
指定使用者角色物件。
類型: | UserRole |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-VirtualHardDisk
指定虛擬硬碟物件。
類型: | VirtualHardDisk |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-VirtualHardDisks
指定虛擬硬碟物件的陣列。
類型: | System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk] |
Position: | 0 |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |
-VirtualizationPlatform
指定 VMM 所管理之虛擬機主機的虛擬化平臺。 此參數可接受的值為:
- HyperV
- VMwareESX
- XENServer
類型: | VirtualizationPlatform |
接受的值: | Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-VMMServer
指定 VMM 伺服器物件。
類型: | ServerConnection |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | True |
接受萬用字元: | False |
輸出
VirtualHardDisk
此 Cmdlet 會傳回 VirtualHardDisk 物件。
備註
- 需要 VMM 虛擬硬碟物件,可以使用 Get-SCVirtualHardDisk Cmdlet 來擷取。