Get-SCISO

  • リファレンス
モジュール:
VirtualMachineManager

VMM ライブラリから ISO ファイルを取得します。

構文

Get-SCISO
   [-VMMServer <ServerConnection>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCISO
   [-VMMServer <ServerConnection>]
   -Name <String>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCISO
   [-VMMServer <ServerConnection>]
   [-Release <String>]
   -FamilyName <String>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCISO
   [-VMMServer <ServerConnection>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

Get-SCISO コマンドレットは、Virtual Machine Manager (VMM) ライブラリから ISO ファイルを取得します。 ISO ファイルは、ライブラリ サーバー上のライブラリ共有に格納されます。

VMM では、ISO ファイルの一般的な用途をいくつか次に示します。

  • 後でそのオペレーティング システムをホストにデプロイされた新規または既存の仮想マシンにインストールするために使用できるオペレーティング システム ISO をライブラリに格納する。

  • Microsoft Office ISO などのアプリケーション ソフトウェアをライブラリに格納して、後でホストにデプロイされた仮想マシンにインストールできるようにします。

例

例 1: すべての VMM ライブラリ サーバー上のすべての ISO を取得する

PS C:\> Get-SCISO -VMMServer "VMMServer01.Contoso.com"

このコマンドは、VMMServer01 上のすべての ISO オブジェクトを取得し、これらの ISO に関する情報を表示します。

取得したオブジェクトが表す ISO ファイルは、ライブラリ サーバー上のライブラリ共有に格納されます。

例 2: 特定の VMM ライブラリ サーバー上のすべての ISO を取得する

PS C:\> Get-SCISO -VMMServer "VMMServer1.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }

このコマンドは、LibraryServer01 に格納されている ISO ファイルを表すすべてのオブジェクトを取得し、これらの ISO に関する情報をユーザーに表示します。

例 3: VMM ライブラリ サーバー上のファイル名に特定の文字列を含むすべての ISO を取得する

PS C:\> Get-SCISO -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match  "OsISO" }

このコマンドは、ファイル名に OsISO を含む VMMServer01 によって管理されているすべての VMM ライブラリ サーバー上のすべての ISO オブジェクトを取得し、これらの ISO オブジェクトに関する情報を表示します。

注: 既定では、ライブラリ内の ISO オブジェクトの名前は、ライブラリ サーバー上のファイル システムに格納されている実際の ISO ファイルの名前と同じ名前になります。

パラメーター

-All

このコマンドレットは、親オブジェクトに依存しないすべての下位オブジェクトを取得することを示します。 たとえば、コマンド Get-SCVirtualDiskDrive -All は、各仮想ディスク ドライブ オブジェクトが関連付けられている仮想マシン オブジェクトまたはテンプレート オブジェクトに関係なく、すべての仮想ディスク ドライブ オブジェクトを取得します。

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

-FamilyName

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

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

-ID

特定のオブジェクトのグローバル一意識別子 (GUID) として数値識別子を指定します。

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

-Name

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

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

-OnBehalfOfUser

ユーザー名を指定します。 このコマンドレットは、このパラメーターが指定したユーザーに代わって動作します。

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

-OnBehalfOfUserRole

ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。

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

-Release

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

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

-VMMServer

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

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

出力

ISO

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