Set-SCScriptCommandSetting
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 $ScriptCmdSettingO 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 de script chamado PreInstall para o perfil de aplicativo armazenado em $AppProfile e armazena o objeto na variável $ScriptCommand.
O terceiro comando obtém o objeto de configuração de comando de script para o comando script armazenado em $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 em $ScriptCommand com as configurações armazenadas em $ScriptCmdSetting.
Parâmetros
-AlwaysReboot
Indica se um computador ou máquina virtual deve ser reiniciado sempre após a execução do script.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CommandMayReboot
Indica que o comando script pode reinicializar o computador ou a máquina virtual.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-FailOnMatch
Indica que a ação tomada quando uma política de falha é correspondida é falhar.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-MatchExitCode
Especifica o código de saída da política de falha.
Formato de exemplo: -MatchExitCode "[1-9][0-9]*"
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-MatchRebootExitCode
Especifica o código de saída de correspondência de política de reinicialização.
Formato de exemplo: -MatchRebootExitCode "{1641}|{3010}|{3011}"
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-MatchStandardError
Especifica o erro padrão da política de falha.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-MatchStandardOutput
Especifica a saída padrão da política de falha.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-PersistStandardErrorPath
Especifica o caminho do arquivo para armazenar o erro padrão.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-PersistStandardOutputPath
Especifica o caminho do arquivo para armazenar a saída padrão.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RestartOnRetry
Indica se um script é reiniciado após a reinicialização do trabalho do VMM se a falha do trabalho anterior ocorreu devido a uma falha de script quando usada em conjunto com New-SCScriptCommandSetting ou Set-SCScriptCommandSetting.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ScriptCommandSetting
Especifica um objeto de configuração de comando de script.
| Tipo: | SCScriptCommandSetting |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-WarnAndContinueOnMatch
Indica que a ação tomada quando uma política de falha é correspondida é avisar o usuário e continuar a operação.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WorkingDirectory
Especifica um diretório de trabalho para um comando de script.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Saídas
ScriptCommandSetting
Esse cmdlet retorna um objeto ScriptCommandSetting.