Set-SCVirtualHardDisk

模組:

VirtualMachineManager

變更 VMM 中使用的虛擬硬碟物件屬性。

Syntax

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

指定虛擬硬碟物件的描述。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Enabled

在設定為 $True 時啟用 物件，或在設定為 $False 時停用 物件。 例如，如果您想升級虛擬機器範本的軟體時，您可以停用 VMM 程式庫的範本物件，暫時禁止使用者使用該物件。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FamilyName

指定 VMM 程式庫中實體資源的系列名稱。 此值會與 Release、Namespace 和 Type 搭配使用，以在程式庫資源之間建立相等性。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-JobGroup

指定一系列命令的識別碼，這些命令會在執行包含相同工作群組識別碼的最終命令之前，使用整組的方式來執行。

Type:	Guid
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

-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

-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

-Release

指定描述程式庫資源發行的字串。 VMM 會自動為每個匯入至程式庫的資源建立發行值。 匯入資源之後，即可自訂字串。

Type:	String
Position:	Named
Default value:	None
Required:	True
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

-SharePath

使用通用命名慣例 (UNC) 路徑格式，指定現有程式庫伺服器上有效程式庫共用的路徑。

範例格式： -SharePath "\\LibServer01\LibShare"

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

指定要與物件建立關聯的單字或片語，以便搜尋具有指定標記集的所有物件。 您可以搜尋標籤子集，也可以搜尋完整的標籤集。

Type:	System.Collections.Generic.List`1[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

-VirtualHardDisk

指定虛擬硬碟物件。

Type:	VirtualHardDisk
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VirtualHardDisks

指定虛擬硬碟物件的陣列。

Type:	System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VirtualizationPlatform

指定 VMM 所管理之虛擬機器主機的虛擬化平台。 此參數可接受的值為：

• HyperV
• VMwareESX
• XENServer

Type:	VirtualizationPlatform
Accepted values:	Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer
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

輸出

VirtualHardDisk

此 Cmdlet 會傳回 VirtualHardDisk 物件。

備註

• 需要 VMM 虛擬硬碟物件，可以使用 Get-SCVirtualHardDisk Cmdlet 來擷取。

相關連結

• Compress-SCVirtualDiskDrive
• Convert-SCVirtualDiskDrive
• Expand-SCVirtualDiskDrive
• Get-SCVirtualDiskDrive
• Get-SCVirtualHardDisk
• Move-SCVirtualHardDisk
• New-SCVirtualDiskDrive
• Remove-SCVirtualDiskDrive
• Remove-SCVirtualHardDisk
• Set-SCVirtualDiskDrive