Set-SCScript

  • リファレンス
モジュール:
VirtualMachineManager

VMM ライブラリに格納されているスクリプトのプロパティを変更します。

構文

Set-SCScript
   [-UserRole <UserRole>]
   [-Enabled <Boolean>]
   [-VMMServer <ServerConnection>]
   [-Script] <Script>
   [-Name <String>]
   [-SharePath <String>]
   [-Description <String>]
   [-Owner <String>]
   [-FamilyName <String>]
   [-Release <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCScript
   [-VMMServer <ServerConnection>]
   [-Scripts] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script]>
   -FamilyName <String>
   -Release <String>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

説明

Set-SCScript コマンドレットは、Virtual Machine Manager (VMM) ライブラリに格納されているスクリプトの 1 つ以上のプロパティを変更します。

次のプロパティを変更できます。

  • [説明]
  • Enabled
  • 名前
  • 所有者
  • SharePath

スクリプト オブジェクトは、ライブラリ サーバー上のライブラリ共有に保管されたスクリプト ファイルを表すものです。 通常、これらのスクリプトは、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"

最初のコマンドは、VMMServer01 のライブラリから Sysprep.inf という名前の応答ファイル スクリプト オブジェクトを取得し、そのオブジェクトを $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"

このコマンドは、所有者が不明である VMM ライブラリからすべてのスクリプト オブジェクトを取得し、各スクリプト オブジェクトの所有者を指定します。

パラメーター

-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

-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

-Script

VMM スクリプト オブジェクトを指定します。

Type:Script
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Scripts

スクリプト オブジェクトの配列を指定します。

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script]
Position:0
Default value:None
Required:True
Accept pipeline input:True
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

出力

Script

このコマンドレットは 、Script オブジェクトを返します。

メモ

  • Get-SCScript コマンドレットを使用して取得できる VMM スクリプト オブジェクトが必要です。