Partilhar via

Set-SCScriptCommandSetting

  • Referência
Módulo:
VirtualMachineManager

Define uma configuração de comando de script.

Sintaxe

Set-SCScriptCommandSetting
   [-ScriptCommandSetting] <SCScriptCommandSetting>
   [-AlwaysReboot <Boolean>]
   [-FailOnMatch]
   [-WarnAndContinueOnMatch]
   [-MatchExitCode <String>]
   [-MatchStandardError <String>]
   [-MatchStandardOutput <String>]
   [-PersistStandardErrorPath <String>]
   [-PersistStandardOutputPath <String>]
   [-MatchRebootExitCode <String>]
   [-RestartScriptOnExitCodeReboot <Boolean>]
   [-WorkingDirectory <String>]
   [-CommandMayReboot]
   [-RestartOnRetry <Boolean>]
   [<CommonParameters>]

Description

O cmdlet Set-SCScriptCommandSetting define uma configuração de comando de script.

Exemplos

Exemplo 1: Atualizar o diretório de trabalho associado ao comando script

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "SvcWebAppProfile01"
PS C:\> $ScriptCommand = Get-SCScriptCommand -ApplicationProfile $AppProfile | where {$_.Name -eq "PreInstall"}
PS C:\> $ScriptCmdSetting = Get-SCScriptCommandSetting -ScriptCommand $ScriptCommand
PS C:\> Set-SCScriptCommandSetting -ScriptCommandSetting $ScriptCmdSetting -WorkingDirectory "Working_Folder_03"
PS C:\> Set-SCScriptCommand -ScriptCommand $ScriptCommand -ScriptCommandSetting $ScriptCmdSetting

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

O segundo comando obtém o comando script chamado PreInstall para o perfil de aplicativo armazenado no $AppProfile e, em seguida, armazena o objeto na variável $ScriptCommand.

O terceiro comando obtém o objeto de configuração de comando script para o comando script armazenado no $ScriptCommand e armazena o objeto na variável $ScriptCmdSetting.

O quarto comando define a configuração do diretório de trabalho como Working_Folder_03.

O último comando atualiza o comando script armazenado no $ScriptCommand com as configurações armazenadas no $ScriptCmdSetting.

Parâmetros

-AlwaysReboot

Indica se um computador ou máquina virtual deve sempre reiniciar após a conclusão da execução do script.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-CommandMayReboot

Indica que o comando script pode reinicializar o computador ou a máquina virtual.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-FailOnMatch

Indica que a ação executada quando uma política de falha é correspondida deve falhar.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MatchExitCode

Especifica o código de saída da política de falha.

Exemplo de formato: -MatchExitCode "[1-9][0-9]*"

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MatchRebootExitCode

Especifica o código de saída de correspondência da política de reinicialização.

Exemplo de formato: -MatchRebootExitCode "{1641}|{3010}|{3011}"

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MatchStandardError

Especifica o erro padrão da política de falha.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MatchStandardOutput

Especifica a saída padrão da política de falhas.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PersistStandardErrorPath

Especifica o caminho do arquivo para armazenar o erro padrão.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PersistStandardOutputPath

Especifica o caminho do arquivo para armazenar a saída padrão.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RestartOnRetry

Indica se um script é reiniciado após a reinicialização do trabalho do VMM se a falha do trabalho anterior foi devido a uma falha de script quando usado em conjunto com New-SCScriptCommandSetting ou Set-SCScriptCommandSetting .

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RestartScriptOnExitCodeReboot

Indica se o script é reiniciado depois que o computador ou a máquina virtual é reiniciado quando um código de saída é correspondido.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ScriptCommandSetting

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

Tipo:SCScriptCommandSetting
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WarnAndContinueOnMatch

Indica que a ação executada quando uma política de falha é correspondida é avisar o usuário e continuar a operação.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WorkingDirectory

Especifica um diretório de trabalho para um comando de script.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Saídas

ScriptCommandSetting

Este cmdlet retorna um objeto ScriptCommandSetting.