Get-SCScript
VMM ライブラリからスクリプト オブジェクトを取得し、任意のスクリプトを表示または編集したり、適切なアクセス許可がある場合は Windows PowerShell スクリプトを表示、編集、または実行したりできます。
構文
All (既定)
Get-SCScript
[-VMMServer <ServerConnection>]
[-All]
[<CommonParameters>]
NameParamSet
Get-SCScript
-Name <String>
[-VMMServer <ServerConnection>]
[<CommonParameters>]
EquivalentResourceParamSet
Get-SCScript
-FamilyName <String>
[-VMMServer <ServerConnection>]
[-Release <String>]
[<CommonParameters>]
ID
Get-SCScript
[-VMMServer <ServerConnection>]
[-ID <Guid>]
[<CommonParameters>]
説明
Get-SCScript コマンドレットは、Virtual Machine Manager (VMM) ライブラリからスクリプト オブジェクトを取得します。 スクリプト オブジェクトが表すスクリプト ファイルは、ライブラリ サーバー上のファイル システムに格納されます。 通常、これらのスクリプトは、Windows PowerShell® スクリプトまたは応答ファイル スクリプト (Sysprep.inf ファイルや、Windows セットアップ プログラムに必要な入力を含む Unattend.xml ファイルを含む) のいずれかです。
例に示すように、 Get-SCScript を使用してスクリプト オブジェクトを取得するだけでなく、適切なアクセス許可がある場合は、スクリプトの内容を表示したり、スクリプトを編集したりすることもできます。 さらに、1) スクリプトが Windows PowerShell スクリプトであること、2) スクリプトがサーバーで有効になっていること、3) 適切なアクセス許可がある場合 (例 5 を参照) に該当する場合も、スクリプトを実行できます。
サーバーで Windows PowerShell スクリプトを有効にする方法については、「 Get-Help about_Signing」、「 Get-Help Get-ExecutionPolicy -Detailed」、および「 Get-Help Set-ExecutionPolicy -Detailed」と入力してください。
例
例 1: すべての VMM ライブラリ サーバーに格納されているすべてのスクリプトを取得する
PS C:\> Get-SCScript -VMMServer "VMMServer01.Contoso.com"
このコマンドは、VMMServer01 の VMM ライブラリのライブラリ共有に格納されているすべてのスクリプト オブジェクトを取得し、これらのスクリプトに関する情報をユーザーに表示します。
例 2: ライブラリー・サーバー上のすべてのスクリプトに関する指定情報の表示
PS C:\> Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" } | Format-List -Property Name, LibraryServer, SharePath
このコマンドは、LibraryServer01 に格納されているすべてのスクリプト オブジェクトを取得し、これらのスクリプトの名前、ライブラリ サーバー、および共有パスをユーザーに表示します。
例 3: 任意の VMM ライブラリ サーバー上の特定の名前を持つすべてのスクリプトを取得する
PS C:\> Get-SCScript -VMMServer "VMMServer1.Contoso.com" | where { $_.Name -eq "Sysprep.inf" }
このコマンドは、VMMServer01 上の任意のライブラリ サーバーに格納されている Sysprep.inf という名前の応答ファイル スクリプト オブジェクトを取得します。
注: デフォルトでは、VMM ライブラリー内のスクリプト・オブジェクトの名前は、ライブラリー・サーバー上の実際のスクリプト・ファイルの名前 (ファイル拡張子を含む) と同じです。
例 4: VMM ライブラリに格納されているスクリプトを表示する
PS C:\> $Script = Get-SCScript | where { $_.Name -eq "SummarizeVMMInfo.ps1"}
PS C:\> Notepad.exe $Script.SharePath
最初のコマンドは、SummarizeVMMInfo.ps1 という名前のスクリプト オブジェクトを VMM ライブラリから取得し、そのオブジェクトを $Script 変数に格納します。
2 番目のコマンドは、メモ帳を使用してスクリプトを開き、スクリプトを読み取るための適切なアクセス許可がある場合は、その内容を表示できるようにします。
注: 適切な書き込み権限がある場合は、スクリプトを編集して新しいバージョンを保存することもできます。
例 5: VMM ライブラリに格納されている Windows PowerShell スクリプトを実行する
PS C:\> $Script = Get-SCScript | where { $_.Name -eq "SummarizeVMMInfo.ps1" }
PS C:\> &$Script.SharePath
最初のコマンドは、VMM ライブラリから "SummarizeVMMInfo.ps1" という名前のスクリプト オブジェクトを取得し、そのオブジェクトを $Script 変数に格納します。
2 番目のコマンドは、アンパサンド (&) 演算子を使用して、$Script に格納されたスクリプトを実行します。
VMM ライブラリ共有に格納されている Windows PowerShell スクリプトを実行するには、次のことを確認する必要があります。
スクリプト ファイルに対する読み取り権限と実行権限を持っている。
VMM 管理者ユーザー ロールのメンバーである。
VMM ライブラリ共有にアクセスするためのアクセス許可があります。
Windows PowerShell スクリプトが有効になっています。 そうでない場合:
VMM コマンド シェルを管理者として実行します。 2. Set-ExecutionPolicy コマンドレットを使用して、実行ポリシーを環境に適したレベルに設定します。
詳細については、「 Get-Help about_Signing」、「 Get-Help Get-ExecutionPolicy -Detailed」、および「 Get-Help Set-ExecutionPolicy -Detailed
パラメーター
-All
このコマンドレットが、親オブジェクトから独立してすべての下位オブジェクトを取得することを示します。
たとえば、コマンド Get-SCVirtualDiskDrive -All は、各仮想ディスク ドライブ オブジェクトが関連付けられている仮想マシン オブジェクトまたはテンプレート オブジェクトに関係なく、すべての仮想ディスク ドライブ オブジェクトを取得します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
All
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FamilyName
VMM ライブラリ内の物理リソースのファミリ名を指定します。 この値は、ライブラリ リソース間の等価性を確立するために、Release、Namespace、および Type と組み合わせて使用されます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
EquivalentResourceParamSet
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ID
数値識別子を、特定のオブジェクトのグローバル一意識別子 (GUID) として指定します。
パラメーターのプロパティ
| 型: | Guid |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ID
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
VMM オブジェクトの名前を指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
NameParamSet
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Release
ライブラリ リソースのリリースを説明する文字列を指定します。 VMM は、ライブラリにインポートされたすべてのリソースに対してリリース値を自動的に作成します。 リソースをインポートした後、文字列をカスタマイズできます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
EquivalentResourceParamSet
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
パラメーターのプロパティ
| 型: | ServerConnection |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
出力
Script
このコマンドレットは Script オブジェクトを返します。