Remove-SCScript

从 VMM 中删除脚本对象。

语法

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

说明

Remove-SCScript cmdlet 从 VMM 库中删除一个或多个脚本对象,并在库服务器上删除相应的脚本文件。

如果脚本附加到模板或硬件配置文件 (且未使用 Force 参数) ,Virtual Machine Manager (VMM) 列出了包含脚本的容器,并提示确认要删除该脚本:

  • 如果答复“是”,VMM 会删除脚本与附加到的容器之间的关联,然后从 VMM 中删除脚本对象。
  • 如果答复否,操作将被取消。

此 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 之前进行确认。

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

指示作业异步运行,以便控件立即返回到命令 shell。

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

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

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