Partilhar via

Add-SCScriptCommand

  • Referência
Módulo:
VirtualMachineManager

Adiciona um comando de script a um perfil de aplicação, implementação de aplicação ou perfil de anfitrião.

Syntax

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

O cmdeto Add-SCScriptCommand adiciona um comando de script a um perfil de aplicação, implementação de aplicação ou perfil de anfitrião. Um comando de script permite que um Administrador execute código durante as operações de implantação e manutenção.

Exemplos

Exemplo 1: Adicionar um comando de script a um perfil de aplicação

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

O primeiro comando obtém o objeto de perfil de aplicação chamado SvcWebAppProfile01 e armazena o objeto na variável $AppProfile.

O segundo comando cria um objeto de definição de comando de script que define o diretório de trabalho para Payload e, em seguida, armazena o objeto na variável $ScriptSetting.

O último comando adiciona um comando de script de pré-instalação ao perfil de aplicação armazenado em $AppProfile.

Parâmetros

-ApplicationDeployment

Especifica um objeto de implementação de aplicação.

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

-ApplicationProfile

Especifica um objeto de perfil de aplicação.

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

-CommandParameters

Especifica os parâmetros para um script ou programa executável.

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

-DeploymentOrder

Especifica a ordem na qual é implantado um nível de computador, anfitrião de aplicação ou aplicação.

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

-Executable

Especifica o nome de um programa executável.

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

-JobGroup

Especifica um identificador para uma série de comandos que funcionarão como um conjunto pouco antes do comando final que inclui o mesmo identificador do grupo de trabalho.

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

-JobVariable

Especifica que o progresso do trabalho é rastreado e armazenado na variável nomeada por este parâmetro.

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

-LibraryResource

Especifica um recurso armazenado na biblioteca Virtual Machine Manager (VMM).

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

-PhysicalComputerProfile

Especifica um perfil que é usado para implantar um sistema operativo num computador.

Type:PhysicalComputerProfile
Aliases:VMHostProfile
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PROTipID

Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

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

-RunAsAccount

Especifica uma conta Run As que contém credenciais com permissão para realizar esta ação.

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

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.

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

-ScriptCommandSetting

Especifica um objeto de definição de comando de script.

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

-ScriptType

Especifica um tipo de guião. Os valores aceitáveis para este parâmetro são:

  • Pré-instalar
  • Pós-Instalação
  • Estado de Salvamento
  • Estado de Restauro
  • Pré-Serviço
  • Pós-Serviço
  • Pré-Instalação
  • PostUninstall
  • Encomendou-me
  • BareMetalPostWinPERegistration
  • OnProvisionFirst
  • OnProvisionRest
  • OnDeleteLast
  • OnDeleterest
  • Instalar
  • BareMetalPostDeployment
Type:ScriptCommandType
Accepted values:PreService, PostService, SaveState, RestoreState, PreInstall, PostInstall, PreUninstall, PostUninstall, OrderedCommand, BareMetalPostWinPERegistration, OnProvisionFirst, OnProvisionRest, OnDeleteLast, OnDeleteRest, Install, BareMetalPostConfiguration, BareMetalPostUnattend
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-StandardInput

Especifica um caminho para um ficheiro que contém informações de entrada padrão para usar com o comando do script.

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

-TimeoutSeconds

Especifica a quantidade de tempo, em segundos, que um processo espera antes do tempo.

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

-VMMServer

Especifica um objeto de servidor Virtual Machine Manager (VMM).

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

Saídas

ScriptCommand

Este cmdlet devolve um objeto ScriptCommand .