Remove-SCScript

VMM からスクリプト オブジェクトを削除します。

構文

Remove-SCScript
      [-Script] <Script>
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Remove-SCScript コマンドレットは、VMM ライブラリから 1 つ以上のスクリプト オブジェクトを削除し、ライブラリ サーバー上の対応するスクリプト ファイルを削除します。

スクリプトがテンプレートまたはハードウェア プロファイルにアタッチされている場合 (および Force パラメーターを使用しない場合)、スクリプトを含むコンテナーが Virtual Machine Manager (VMM) に一覧表示され、スクリプトを削除するかどうかを確認するメッセージが表示されます。

  • [はい] と応答すると、VMM は、スクリプトとそれがアタッチされているコンテナーの間の関連付けを削除し、VMM からスクリプト オブジェクトを削除します。
  • 「いいえ」と応答すると、操作は取り消されます。

このコマンドレットは、成功した場合 (MarkedForDeletion プロパティが$Trueに設定されている) オブジェクトを返すか、失敗した場合にエラー メッセージを返します。

例 1: スクリプト オブジェクトを削除し、対応するスクリプト ファイルを削除する

PS C:\> $Scripts = @(Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AddHost.ps1"} )
PS C:\> $Scripts.Count
PS C:\> $Scripts | select Name,SharePath | Format-List
PS C:\> Remove-SCScript -Script $Scripts[0] -Force

最初のコマンドは、VMMServer01 上の VMM ライブラリから AddHost.ps1 という名前のスクリプト オブジェクトを取得し、そのオブジェクトを $Scripts という名前の配列に格納します。 指定したライブラリ サーバーにスクリプトのコンテナが複数存在する場合は、同じ名前を持つファイルが複数存在する可能性があります。

2 番目のコマンドは、$Scrips内のスクリプトの数をカウントし、結果をユーザーに表示します。

3 番目のコマンドは、$Scripts内の各スクリプト オブジェクトを Select-Object コマンドレットに渡します。このコマンドレットは、配列内の各スクリプトの名前と共有パスを選択します。 次に、これらの結果を Format-List コマンドレットに渡して、各スクリプト名とその共有パスをユーザーに表示します。

最後のコマンドは、$Scripts 配列内の最初のオブジェクトを削除し、 Force パラメーターを使用して、スクリプト オブジェクトが VMM データベースから削除され、対応するスクリプト ファイルがライブラリ サーバー上のファイル システムから削除されるようにします。

例 2: ライブラリから複数のスクリプトを削除する

PS C:\> $Scripts = Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "Sysprep" }
PS C:\> $Scripts | Remove-SCScript -Confirm

最初のコマンドは、VMMServer01 から文字列 "Sysprep" を含む名前を持つすべてのスクリプト オブジェクトを取得し、これらのオブジェクトを $Scripts という名前の配列に格納します。

2 番目のコマンドは、$Scripts内の各スクリプト オブジェクトを Remove-SCScript に渡します。これにより、ライブラリから各スクリプト オブジェクトが削除され、対応する各スクリプト ファイルがライブラリ サーバー上のファイル システムから削除されます。

Confirm パラメーターを使用すると、これらのスクリプトを削除するかどうかを確認するメッセージが表示されます。 すべてのスクリプトの削除を一度に確認するか、各スクリプトの削除を 1 つずつ確認することができます。

パラメーター

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

ユーザーに確認せずに、直ちにコマンドを実行します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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

-PROTipID

このアクションをトリガーしたパフォーマンスとリソース最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。

Type:Guid
Position:Named
Default value:None
Required:False
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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False