Set-SCScript

更改存储在 VMM 库中的脚本的属性。

语法

Set-SCScript
   [-UserRole <UserRole>]
   [-Enabled <Boolean>]
   [-VMMServer <ServerConnection>]
   [-Script] <Script>
   [-Name <String>]
   [-SharePath <String>]
   [-Description <String>]
   [-Owner <String>]
   [-FamilyName <String>]
   [-Release <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCScript
   [-VMMServer <ServerConnection>]
   [-Scripts] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script]>
   -FamilyName <String>
   -Release <String>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

说明

Set-SCScript cmdlet 更改存储在 Virtual Machine Manager (VMM) 库中的脚本的一个或多个属性。

您可以更改的属性包括:

  • 说明
  • Enabled
  • 名称
  • 所有者
  • SharePath

脚本对象代表存储在库服务器上的库共享中的脚本文件。 通常,这些脚本是Windows PowerShell ®脚本或应答文件 (,如 Sysprep.inf 或包含 Windows 安装程序所需的输入的Unattend.xml文件) 。

示例

示例 1:更改脚本的说明

PS C:\> $Script = Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "Sysprep.inf" }
PS C:\> Set-SCScript -Script $Script -Description "Windows Server 2008 R2 Sysprep Answer File"

第一个命令从 VMMServer01 上的库中检索名为 Sysprep.inf 的应答文件脚本对象,然后将该对象存储在$Script变量中。

第二个命令将此脚本对象的说明更改为“Windows Server 2008 R2 Sysprep 应答文件”。

示例 2:禁用存储在 VMM 库中的Windows PowerShell脚本

PS C:\> $Script = Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AddHost.ps1" }
PS C:\> Set-SCScript -Script $Script -Enabled $FALSE

第一个命令获取名为AddHost.ps1的 PowerShell 脚本对象,并将对象存储在$Script变量中。

第二个命令禁用存储在$Script中的脚本。

示例 3:为具有未知所有者的所有脚本指定所有者

PS C:\> Get-SCScript -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-SCScript -Owner "Contoso\PattiFuller"

此命令从 VMM 库中获取其所有者未知的所有脚本对象,然后为每个脚本对象指定所有者。

参数

-Description

指定脚本的说明。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Enabled

在设置为$True时启用对象,或者在设置为$False时禁用对象。 例如,如果您要对虚拟机模板上的软件进行升级,则可以禁用 VMM 库中的模板对象以临时阻止用户使用该对象。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FamilyName

指定 VMM 库中物理资源的系列名称。 此值与发布、命名空间和类型结合使用,在库资源之间建立等效性。

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

-Name

指定 VMM 对象的名称。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Owner

以一个有效的域用户帐户形式指定 VMM 对象的所有者。

  • 示例格式: -Owner "Contoso\PattiFuller"
  • 示例格式: -Owner "PattiFuller@Contoso"
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

-Release

指定描述库资源的发布的字符串。 VMM 会自动为导入库中的每个资源创建发布值。 导入资源后,可以自定义字符串。

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

-Scripts

指定脚本对象的数组。

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.Script]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SharePath

指定现有库服务器上使用通用命名约定 (UNC) 路径的一个有效库共享路径。

示例格式: -SharePath \\LibServer01\LibShare.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserRole

指定一个用户角色对象。

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

指定VMM 服务器对象。

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

输出

Script

此 cmdlet 返回 脚本 对象。

备注

  • 需要 VMM 脚本对象,可以使用 Get-SCScript cmdlet 检索该对象。