Remove-SCScript
从 VMM 中删除脚本对象。
语法
Default (默认值)
Remove-SCScript
[-Script] <Script>
[-Force]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Remove-SCScript cmdlet 从 VMM 库中删除一个或多个脚本对象,并删除库服务器上的相应脚本文件。
如果脚本附加到模板或硬件配置文件(并且不使用 Force 参数),Virtual Machine Manager (VMM) 会列出包含该脚本的容器,并提示您确认是否要删除该脚本:
- 如果回答“是”,则 VMM 将删除脚本与其附加到的容器之间的关联,然后从 VMM 中删除脚本对象。
- 如果回答 No (否),则作将被取消。
此 cmdlet 在成功时返回对象(并将属性 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 的数组中。 如果指定的库服务器上存在多个脚本容器,则可能存在多个同名文件。
第二个命令对 $Scrips 中的脚本数量进行计数,并向用户显示结果。
第三个命令将 $Scripts 中的每个脚本对象传递给 Select-Object cmdlet,该 cmdlet 为数组中的每个脚本选择名称和共享路径。 然后,该命令将这些结果传递给 Format-List cmdlet,以向用户显示每个脚本名称及其共享路径。
最后一个命令删除 $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 的数组中。
第二个命令将$Scripts中的每个脚本对象传递给 Remove-SCScript,后者从库中删除每个脚本对象,并从库服务器上的文件系统中删除每个相应的脚本文件。
的 Confirm 参数会提示您确认确实要删除这些脚本。 您可以选择一次确认删除所有脚本,也可以逐个确认删除每个脚本。
参数
-Confirm
在运行 cmdlet 之前,提示你进行确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Force
强制命令运行而不要求用户确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-JobVariable
指定在由该参数命名的变量中跟踪和存储作业进度。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-PROTipID
指定触发此操作的性能和资源优化提示(PRO 提示)的 ID。 此参数允许你审核 PRO 提示。
参数属性
| 类型: | Guid |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-RunAsynchronously
指示作业以异步方式运行,以便控件立即返回到命令行界面。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Script
指定 VMM 脚本对象。
参数属性
| 类型: | Script |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。
参数属性
| 类型: | SwitchParameter |
| 默认值: | False |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。