Remove-SCScript

構文

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

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

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

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

パラメーター

-Confirm

-Force

-JobVariable

-PROTipID

-RunAsynchronously

-Script

-WhatIf

関連リンク

• Get-SCScript
• Set-SCScript