Compartilhar via


Set-SCScriptCommandSetting

Define uma configuração de comando de script.

Sintaxe

Default (Padrão)

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 do 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 no $AppProfile e, em seguida, armazena o objeto na variável $ScriptCommand.

O terceiro comando obtém o objeto de configuração do comando de script para o comando de 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 de 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.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-CommandMayReboot

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-FailOnMatch

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MatchExitCode

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

Formato de exemplo: -MatchExitCode "[1-9][0-9]*"

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MatchRebootExitCode

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

Formato de exemplo: -MatchRebootExitCode "{1641}|{3010}|{3011}"

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MatchStandardError

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MatchStandardOutput

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PersistStandardErrorPath

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PersistStandardOutputPath

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RestartOnRetry

Indica se um script é reiniciado na 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.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ScriptCommandSetting

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

Propriedades do parâmetro

Tipo:SCScriptCommandSetting
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WarnAndContinueOnMatch

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WorkingDirectory

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

ScriptCommandSetting

Esse cmdlet retorna um objeto ScriptCommandSetting .