Share via


Set-SCScript

變更儲存在 VMM 程式庫中的腳本屬性。

Syntax

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>]

Description

Set-SCScript Cmdlet 會變更儲存在 Virtual Machine Manager (VMM) 程式庫中之腳本的一或多個屬性。

您可以變更的內容包括:

  • 描述
  • 啟用
  • 名稱
  • 擁有者
  • 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"

此命令會從擁有者為 Unknown 的 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 程式庫中實體資源的系列名稱。 此值會與 Release、Namespace 和 Type 搭配使用,以在程式庫資源之間建立相等性。

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 提示 (PRO 提示的識別碼) 。 此參數可讓您稽核 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

表示作業會以非同步方式執行,讓控制項立即返回命令殼層。

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 會傳回 Script 物件。

備註

  • 需要 VMM 腳本物件,可以使用 Get-SCScript Cmdlet 來擷取。