次の方法で共有


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 スクリプト オブジェクトが必要です。