Set-SCScript
VMM ライブラリに格納されているスクリプトのプロパティを変更します。
構文
Default
Set-SCScript
[-Script] <Script>
[-UserRole <UserRole>]
[-Enabled <Boolean>]
[-VMMServer <ServerConnection>]
[-Name <String>]
[-SharePath <String>]
[-Description <String>]
[-Owner <String>]
[-FamilyName <String>]
[-Release <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
EquivalencySet
Set-SCScript
[-Scripts] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script]>
-FamilyName <String>
-Release <String>
[-VMMServer <ServerConnection>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
説明
Set-SCScript コマンドレットは、Virtual Machine Manager (VMM) ライブラリに格納されているスクリプトの 1 つ以上のプロパティを変更します。
変更できるプロパティには、次のものがあります。
スクリプト オブジェクトは、ライブラリ サーバー上のライブラリ共有に格納されたスクリプト ファイルを表します。
通常、これらのスクリプトは、Windows PowerShell スクリプト、または Windows セットアップ プログラムに必要な入力を含む Windows PowerShell® 応答ファイル (Sysprep.inf や Unattend.xml ファイルなど) のいずれかです。
例
例 1: スクリプトの説明を変更する
PS C:\> $Script = Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "Sysprep.inf" }
PS C:\> Set-SCScript -Script $Script -Description "Windows Server 2008 R2 Sysprep Answer File"
最初のコマンドは、Sysprep.inf という名前の応答ファイル スクリプト オブジェクトを VMMServer01 のライブラリから取得し、そのオブジェクトを $Script 変数に格納します。
2 番目のコマンドは、このスクリプト オブジェクトの説明を "Windows Server 2008 R2 Sysprep Answer File" に変更します。
例 2: VMM ライブラリに格納されている Windows PowerShell スクリプトを無効にする
PS C:\> $Script = Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AddHost.ps1" }
PS C:\> Set-SCScript -Script $Script -Enabled $FALSE
最初のコマンドは、AddHost.ps1 という名前の PowerShell スクリプト オブジェクトを取得し、そのオブジェクトを $Script 変数に格納します。
2 番目のコマンドは、$Script に格納されているスクリプトを無効にします。
例 3: 所有者が不明なすべてのスクリプトの所有者を指定する
PS C:\> Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-SCScript -Owner "Contoso\PattiFuller"
このコマンドは、所有者が Unknown であるすべてのスクリプト オブジェクトを VMM ライブラリから取得し、各スクリプト オブジェクトの所有者を指定します。
パラメーター
-Description
スクリプトの説明を指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Default
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Enabled
$True に設定するとオブジェクトが有効になり、$False に設定するとオブジェクトが無効になります。
たとえば、バーチャル マシン テンプレートのソフトウェアをアップグレードする場合は、VMM ライブラリ内のテンプレート オブジェクトを無効にして、ユーザーがそのオブジェクトを一時的に使用できないようにすることができます。
パラメーターのプロパティ
| 型: | Boolean
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Default
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FamilyName
VMM ライブラリ内の物理リソースのファミリ名を指定します。
この値は、ライブラリ リソース間の等価性を確立するために、Release、Namespace、および Type と組み合わせて使用されます。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Default
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-JobVariable
ジョブの進行状況を追跡され、このパラメーターで指定された変数に格納するように指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
VMM オブジェクトの名前を指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Default
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Owner
有効なドメイン ユーザー アカウントの形式で VMM オブジェクトの所有者を指定します。
- 形式の例:
-Owner "Contoso\PattiFuller"
- 形式の例:
-Owner "PattiFuller@Contoso"
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Default
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。
このパラメーターを使用すると、PRO のヒントを監査できます。
パラメーターのプロパティ
| 型: | Guid
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Release
ライブラリ リソースのリリースを説明する文字列を指定します。
VMM は、ライブラリにインポートされたすべてのリソースに対してリリース値を自動的に作成します。
リソースをインポートした後、文字列をカスタマイズできます。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Default
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Script
VMM スクリプト オブジェクトを指定します。
パラメーターのプロパティ
| 型: | Script
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Default
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Scripts
スクリプト オブジェクトの配列を指定します。
パラメーターのプロパティ
| 型: | System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script]
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
EquivalencySet
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SharePath
汎用名前付け規則 (UNC) パスを使用する既存のライブラリ サーバー上の有効なライブラリ共有へのパスを指定します。
形式の例: -SharePath \\LibServer01\LibShare。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Default
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UserRole
ユーザー ロール オブジェクトを指定します。
パラメーターのプロパティ
| 型: | UserRole
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Default
| 配置: | 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 オブジェクトを返します。
メモ
-
Get-SCScript コマンドレットを使用して取得できる VMM スクリプト オブジェクトが必要です。