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 |