Set-SCCustomResource
カスタム リソースのプロパティを設定します。
構文
Set-SCCustomResource
[-UserRole <UserRole>]
[-Enabled <Boolean>]
[-VMMServer <ServerConnection>]
[-CustomResource] <CustomResource[]>
[-Name <String>]
[-SharePath <String>]
[-Description <String>]
[-Owner <String>]
[-FamilyName <String>]
[-Release <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
Set-SCCustomResource
[-VMMServer <ServerConnection>]
[-CustomResource] <CustomResource[]>
[-SetAsEquivalent]
-FamilyName <String>
-Release <String>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
説明
Set-SCCustomResource コマンドレットは、カスタム リソースのプロパティを設定します。 カスタム リソースは、Virtual Machine Manager (VMM) のフォルダー ベースのライブラリ オブジェクトです。 リソースはフォルダー レベルで宣言され、フォルダーの内容は VMM では不明です。
VMM ライブラリにカスタム リソースを追加するには、CR 拡張機能を使用して、フォルダーにコンテンツを配置し、VMM コンソールを使用して、VMM ライブラリ共有にフォルダーをドラッグします。 VMM は、フォルダーを検出し、カスタム リソースとして VMM ライブラリにインポートします。
例
例 1: カスタム リソースの説明とリリースを変更する
PS C:\> $CR = Get-SCCustomResource -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "Folder.CR" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Set-SCCustomResource -CustomResource $CR -Release "v1.1" -Description "My LOB Application version 1.1 Install Package"
最初のコマンドは、VMMServer01 上の VMM ライブラリから LibraryServer01 Folder.CR という名前のカスタム リソース オブジェクトを取得し、そのオブジェクトを $CR 変数に格納します。
2 番目のコマンドは、$CRに格納されているカスタム リソース オブジェクトのプロパティ、
パラメーター
-CustomResource
カスタム リソース オブジェクトの配列を指定します。
型: | CustomResource[] |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-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 |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
VMM オブジェクトの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Owner
有効なドメイン ユーザー アカウントの形式で VMM オブジェクトの所有者を指定します。
- 形式の例:
-Owner "Contoso\PattiFuller"
- 形式の例:
-Owner "PattiFuller@Contoso"
型: | 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 |
-SetAsEquivalent
コマンドレットが複数のカスタム リソースを同等としてマークすることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SharePath
汎用名前付け規則 (UNC) パスを使用する既存のライブラリ サーバー上の有効なライブラリ共有へのパスを指定します。
形式の例: -SharePath "\\LibServer01\LibShare"
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UserRole
ユーザー ロール オブジェクトを指定します。
型: | UserRole |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
型: | ServerConnection |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
出力
CustomResource
このコマンドレットは、CustomResource オブジェクトを返します。