Set-SCApplicationPackage
アプリケーション パッケージのプロパティを変更します。
構文
Set-SCApplicationPackage
[-UserRole <UserRole>]
[-Enabled <Boolean>]
[-VMMServer <ServerConnection>]
[-ApplicationPackage] <ApplicationPackage[]>
[-EncryptionKey <PSCredential>]
[-Name <String>]
[-SharePath <String>]
[-Description <String>]
[-Owner <String>]
[-FamilyName <String>]
[-Release <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Set-SCApplicationPackage
[-VMMServer <ServerConnection>]
[-ApplicationPackage] <ApplicationPackage[]>
[-SetAsEquivalent]
-FamilyName <String>
-Release <String>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] 説明
Set-SCApplicationPackage コマンドレットは、仮想マシン マネージャー (VMM) ライブラリに格納されているアプリケーション パッケージのプロパティを変更します。
例
例 1: アプリケーション パッケージの説明を更新する
PS C:\> $AppPackage = Get-SCApplicationPackage -Name "WebApp01.zip"
PS C:\> Set-SCApplicationPackage -ApplicationPackage $AppPackage -Description "Web application to install on a service."最初のコマンドは、WebApp01.zipという名前のアプリケーション パッケージ オブジェクトを取得し、そのオブジェクトを$AppPackage変数に格納します。
2 番目のコマンドは、WebApp01.zipの説明を更新します。
パラメーター
-ApplicationPackage
アプリケーション パッケージ オブジェクトの配列を指定します。
| Type: | ApplicationPackage[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-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 |
-EncryptionKey
境界ネットワークにある Hyper-V ホストを VMM に追加するときに、暗号化キーとして使用する資格情報を指定します。
形式の例: -SecurityFile "C:\SecurityFile.txt" -EncryptionKey $Key
| Type: | PSCredential |
| 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 |
-SetAsEquivalent
コマンドレットが複数のアプリケーション パッケージを同等としてマークすることを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
-VMMServer
VMM サーバー オブジェクトを指定します。
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
出力
ApplicationPackage
このコマンドレットは 、ApplicationPackage オブジェクトを返します。