次の方法で共有


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>]

説明

Set-SCVirtualHardDisk コマンドレットは、仮想マシン マネージャー (VMM) 環境で使用される仮想ハード ディスク オブジェクトの 1 つ以上のプロパティを変更します。 VMM で使用される仮想ハード ディスク ファイルは、Windows ベースの .vhd ファイル、Citrix XenServer ベースの .vhd ファイル、または VMware ベースの .vmdk ファイルです。

変更できるプロパティは次のとおりです。

  • 形容
  • 有効
  • 名前
  • オペレーティング システム
  • 所有者
  • SharePath

仮想ハード ディスク ファイルは、VMM ライブラリに格納されているか、仮想マシンまたはテンプレート上の仮想ディスク ドライブに接続されている可能性があります。

仮想ディスク ドライブのバスと LUN の設定を変更するには、Set-SCVirtualDiskDrive コマンドレットを使用します。

例 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 変数に格納します。

2 番目のコマンドは、$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 変数に格納します。

2 番目のコマンドは、$VMDKに格納されている仮想ハード ディスク オブジェクトを無効にします。

例 3: "不明" 所有者を持つすべての仮想ハード ディスクの所有者を指定する

PS C:\> Get-SCVirtualHardDisk -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-SCVirtualHardDisk -Owner "Contoso\ReneeLo"

このコマンドは、所有者が "Unknown" である VMM ライブラリからすべての仮想ハード ディスク オブジェクトを取得し、各仮想ハード ディスク オブジェクトの所有者を指定します。

パラメーター

-Description

仮想ハード ディスク オブジェクトの説明を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Enabled

$Trueに設定されている場合はオブジェクトを有効にするか、$Falseに設定するとオブジェクトを無効にします。 たとえば、仮想マシン テンプレートでソフトウェアをアップグレードする場合は、VMM ライブラリのテンプレート オブジェクトを無効にして、ユーザーがそのオブジェクトを一時的に使用できないようにすることができます。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FamilyName

VMM ライブラリ内の物理リソースのファミリ名を指定します。 この値は、ライブラリ リソース間の等価性を確立するために、Release、Namespace、Type と組み合わせて使用されます。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-JobGroup

同じジョブ グループ識別子を含む最後のコマンドが実行される直前にセットとして実行される一連のコマンドの識別子を指定します。

型:Guid
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-JobVariable

ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

VMM オブジェクトの名前を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-OperatingSystem

仮想マシンのオペレーティング システムの種類を指定します。 VMM で使用可能なすべてのオペレーティング システムの名前を一覧表示するには、「Get-SCOperatingSystem」と入力します。

型:OperatingSystem
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Owner

有効なドメイン ユーザー アカウントの形式で VMM オブジェクトの所有者を指定します。

  • 形式の例: -Owner "Contoso\PattiFuller"
  • 形式の例: -Owner "PattiFuller@Contoso"
型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ProductKey

プロダクト キーを指定します。 プロダクト キーは、製品ライセンスを識別する 25 桁の番号です。 プロダクト キーを使用して、VMM または仮想マシンまたはホストにインストールするオペレーティング システムを登録できます。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PROTipID

このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。

型:Guid
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Release

ライブラリ リソースのリリースを記述する文字列を指定します。 VMM は、ライブラリにインポートされるすべてのリソースのリリース値を自動的に作成します。 リソースがインポートされたら、文字列をカスタマイズできます。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RunAsynchronously

コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SharePath

汎用名前付け規則 (UNC) パスを使用する既存のライブラリ サーバー上の有効なライブラリ共有へのパスを指定します。

形式の例: -SharePath "\\LibServer01\LibShare"

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Tag

指定したタグのセットを持つすべてのオブジェクトを検索できるように、オブジェクトに関連付ける単語または語句を指定します。 タグのサブセットを検索することも、タグの完全なセットを検索することもできます。

型:System.Collections.Generic.List`1[System.String]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UserRole

ユーザー ロール オブジェクトを指定します。

型:UserRole
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VirtualHardDisk

仮想ハード ディスク オブジェクトを指定します。

型:VirtualHardDisk
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-VirtualHardDisks

仮想ハード ディスク オブジェクトの配列を指定します。

型:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualHardDisk]
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-VirtualizationPlatform

VMM によって管理される仮想マシン ホストの仮想化プラットフォームを指定します。 このパラメーターに使用できる値は次のとおりです。

  • HyperV
  • VMwareESX
  • XENServer
型:VirtualizationPlatform
指定可能な値:Unknown, VirtualServer, HyperV, VMWareVC, VMWareESX, XENServer
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VMMServer

VMM サーバー オブジェクトを指定します。

型:ServerConnection
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

出力

VirtualHardDisk

このコマンドレットは、VirtualHardDisk オブジェクトを返します。

メモ

  • Get-SCVirtualHardDisk コマンドレットを使用して取得できる VMM 仮想ハード ディスク オブジェクトが必要です。