共用方式為

Add-SCScriptCommand

  • 參考
模組:
VirtualMachineManager

將文稿命令新增至應用程式配置檔、應用程式部署或主機配置檔。

語法

Add-SCScriptCommand
   -ApplicationProfile <ApplicationProfile>
   [-Executable <String>]
   [-CommandParameters <String>]
   [-ScriptCommandSetting <SCScriptCommandSetting>]
   -ScriptType <ScriptCommandType>
   [-TimeoutSeconds <Int32>]
   [-StandardInput <String>]
   [-LibraryResource <CustomResource>]
   [-RunAsAccount <VMMCredential>]
   [-VMMServer <ServerConnection>]
   [-DeploymentOrder <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Add-SCScriptCommand
   -ApplicationDeployment <ApplicationDeployment>
   [-Executable <String>]
   [-CommandParameters <String>]
   [-ScriptCommandSetting <SCScriptCommandSetting>]
   -ScriptType <ScriptCommandType>
   [-TimeoutSeconds <Int32>]
   [-StandardInput <String>]
   [-LibraryResource <CustomResource>]
   [-RunAsAccount <VMMCredential>]
   [-VMMServer <ServerConnection>]
   [-DeploymentOrder <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Add-SCScriptCommand
   -PhysicalComputerProfile <PhysicalComputerProfile>
   [-Executable <String>]
   [-CommandParameters <String>]
   [-ScriptCommandSetting <SCScriptCommandSetting>]
   -ScriptType <ScriptCommandType>
   [-TimeoutSeconds <Int32>]
   [-StandardInput <String>]
   [-LibraryResource <CustomResource>]
   [-RunAsAccount <VMMCredential>]
   [-VMMServer <ServerConnection>]
   [-JobGroup <Guid>]
   [-DeploymentOrder <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Add-SCScriptCommand
   [-Executable <String>]
   [-CommandParameters <String>]
   [-ScriptCommandSetting <SCScriptCommandSetting>]
   -ScriptType <ScriptCommandType>
   [-TimeoutSeconds <Int32>]
   [-StandardInput <String>]
   [-LibraryResource <CustomResource>]
   [-RunAsAccount <VMMCredential>]
   [-VMMServer <ServerConnection>]
   [-JobGroup <Guid>]
   [-DeploymentOrder <Int32>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

Add-SCScriptCommand Cmdlet 會將腳本命令新增至應用程式設定檔、應用程式部署或主機配置檔。 腳本命令可讓系統管理員在部署和維護作業期間執行程序代碼。

範例

範例 1：將文稿命令新增至應用程式設定檔

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "SvcWebAppProfile01"
PS C:\> $ScriptSetting = New-SCScriptCommandSetting -WorkingDirectory "Working_Folder_01"
PS C:\> Add-SCScriptCommand -ApplicationProfile $AppProfile -Executable "Startup.ps1" -ScriptType "PreInstall" -ScriptCommandSetting $ScriptSetting -TimeoutSeconds 120

第一個命令會取得名為 SvcWebAppProfile01 的應用程式配置檔物件，並將物件儲存在$AppProfile變數中。

第二個命令會建立腳本命令設定物件，將工作目錄設定為Payload，然後將物件儲存在$ScriptSetting變數中。

最後一個命令會將預安裝腳本命令新增至儲存在 $AppProfile 中的應用程式配置檔。

參數

-ApplicationDeployment

指定應用程式部署物件。

類型:ApplicationDeployment
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ApplicationProfile

指定應用程式設定檔物件。

類型:ApplicationProfile
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-CommandParameters

指定文稿或可執行程序的參數。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DeploymentOrder

指定部署電腦層、應用程式主機或應用程式的順序。

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Executable

指定可執行程序的名稱。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-JobGroup

指定一系列命令的標識碼，這些命令將在包含相同作業群組標識符的執行的最後一個命令之前，以集合的形式執行。

類型:Guid
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-JobVariable

指定作業進度會追蹤並儲存在此參數所命名的變數中。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-LibraryResource

指定儲存在 Virtual Machine Manager （VMM） 連結庫中的資源。

類型:CustomResource
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-PhysicalComputerProfile

指定用來將作業系統部署至計算機的配置檔。

類型:PhysicalComputerProfile
別名:VMHostProfile
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-PROTipID

指定觸發此動作之效能和資源優化提示 （PRO 提示） 的識別碼。 此參數可讓您稽核 PRO 秘訣。

類型:Guid
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RunAsAccount

指定執行身分帳戶，其中包含具有執行此動作許可權的認證。

類型:VMMCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RunAsynchronously

表示作業會以異步方式執行，讓控件立即返回命令殼層。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ScriptCommandSetting

指定文稿命令設定物件。

類型:SCScriptCommandSetting
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ScriptType

指定文稿類型。 此參數可接受的值為：

  • 預安裝
  • PostInstall
  • SaveState
  • RestoreState
  • PreService
  • PostService
  • PreUninstall
  • PostUninstall
  • OrderedCommand
  • BareMetalPostWinPERegistration
  • OnProvisionFirst
  • OnProvisionRest
  • OnDeleteLast
  • OnDeleteRest
  • 安裝
  • BareMetalPostDeployment
類型:ScriptCommandType
接受的值:PreService, PostService, SaveState, RestoreState, PreInstall, PostInstall, PreUninstall, PostUninstall, OrderedCommand, BareMetalPostWinPERegistration, OnProvisionFirst, OnProvisionRest, OnDeleteLast, OnDeleteRest, Install, BareMetalPostConfiguration, BareMetalPostUnattend
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-StandardInput

指定檔案的路徑，其中包含要搭配腳本命令使用的標準輸入資訊。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-TimeoutSeconds

指定行程在逾時前等候的時間量，以秒為單位。

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-VMMServer

指定 Virtual Machine Manager （VMM） 伺服器物件。

類型:ServerConnection
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸出

ScriptCommand

此 Cmdlet 會傳回 ScriptCommand 物件。