Set-SCVirtualFloppyDisk

VMM で使用される仮想フロッピー ディスクのプロパティを変更します。

構文

Set-SCVirtualFloppyDisk
   [-UserRole <UserRole>]
   [-Enabled <Boolean>]
   [-VMMServer <ServerConnection>]
   [-VirtualFloppyDisk] <VirtualFloppyDisk>
   [-Name <String>]
   [-SharePath <String>]
   [-Description <String>]
   [-Owner <String>]
   [-FamilyName <String>]
   [-Release <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualFloppyDisk
   [-VMMServer <ServerConnection>]
   [-VirtualFloppyDisks] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.VirtualFloppyDisk]>
   -FamilyName <String>
   -Release <String>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

説明

Set-SCVirtualFloppyDisk コマンドレットは、Virtual Machine Manager (VMM) 環境で使用される仮想フロッピー ディスクの 1 つ以上のプロパティを変更します。 VMM で使用される仮想フロッピー ディスク ファイルは、Windows ベースの .vfd ファイルまたは VMware ベースの .flp ファイルです。

次のプロパティを変更できます。

  • [説明]

  • Enabled

  • 名前

  • 所有者

  • SharePath

仮想フロッピー ディスク ファイルを VMM ライブラリに格納することも、仮想フロッピー ディスクを仮想マシンに追加することもできます。

例 1: 仮想フロッピー ディスクの説明を変更する

PS C:\> $VFD = Get-SCVirtualFloppyDisk -VMMServer "VMMServer01.Contoso.com"  | where { $_.Name -eq "BootFloppy.vfd" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Set-SCVirtualFloppyDisk -VirtualFloppyDisk $VFD -Description "Latest Boot Floppy"

最初のコマンドは、ファイルが LibraryServer01 に格納されている VMMServer01 上の VMM ライブラリから BootFloppy.vfd という名前のフロッピー ディスク オブジェクトを取得し、そのオブジェクトを $VFD 変数に格納します。

2 番目のコマンドは、$VFDに格納されている仮想フロッピー ディスク オブジェクトの説明を "Latest Boot フロッピー" に変更します。

例 2: 仮想フロッピー ディスクを無効にする

PS C:\> $VFD = Get-SCVirtualFloppyDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "BootFloppy.vfd" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Set-SCVirtualFloppyDisk -VirtualFloppyDisk $VFD -Enabled $FALSE

最初のコマンドは、ファイルが LibraryServer01 に格納されている BootFloppy.vfd という名前の仮想フロッピー ディスク オブジェクトを取得し、そのオブジェクトを $VFD 変数に格納します。

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

例 3: VMware ベースの仮想フロッピー ディスクの名前を変更する

PS C:\> $FLP = Get-SCVirtualFloppyDisk -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "ESXBootFloppy.flp" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Set-SCVirtualFloppyDisk -VirtualFloppyDisk $FLP -Name "ESXBootFloppy-Beta.flp"

最初のコマンドは、LibraryServer01 の ESXBootFloppy.flp という名前のフロッピー ディスク オブジェクトを取得し、そのオブジェクトを $FLP 変数に格納します。

2 番目のコマンドは、$FLPに格納されている仮想フロッピー ディスク オブジェクトの名前を ESXBootFloppy-Beta.flp に変更します。

注: 既定では、ライブラリ内の仮想フロッピー ディスク オブジェクトの名前は、ライブラリ共有上の実際の仮想フロッピー ディスク ファイルの名前と同じ名前 (拡張子を含む) になります。 ライブラリ内の仮想フロッピー ディスク オブジェクトの名前を変更しても、ライブラリ サーバーに格納されている実際の仮想フロッピー ディスク ファイルの名前は変更されません。

例 4: "不明" 所有者を持つすべての仮想フロッピー ディスクの所有者を指定する

PS C:\> Get-SCVirtualFloppyDisk -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-SCVirtualFloppyDisk -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

-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

-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

-PROTipID

このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、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

-UserRole

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

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

-VirtualFloppyDisk

バーチャル フロッピー ディスク オブジェクトを指定します。

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

-VirtualFloppyDisks

フロッピー ディスク オブジェクトの配列を指定します。

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

-VMMServer

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

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

出力

VirtualFloppyDisk

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

メモ

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