Compartilhar via


New-SCScriptCommandSetting

Cria um objeto de configurações para um comando de script.

Syntax

New-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 New-SCScriptCommandSetting cria um objeto de configurações para um comando de script.

Exemplos

Exemplo 1: adicionar uma configuração de diretório de trabalho a um comando de script

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

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 objeto de comando de script chamado PostInstall para o perfil de aplicativo armazenado em $AppProfile.

O terceiro comando cria uma nova configuração de comando de script que define o diretório de trabalho como Working_Folder_02 e armazena o objeto na variável $ScriptSetting.

O último comando atualiza o diretório de trabalho para o comando de script armazenado em $ScriptCommand ser Working_Folder_02 (o valor de $ScriptSetting).

Parâmetros

-AlwaysReboot

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

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

-CommandMayReboot

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

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

-FailOnMatch

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

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

-MatchExitCode

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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}"

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

-MatchStandardError

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

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

-MatchStandardOutput

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

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

-PersistStandardErrorPath

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

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

-PersistStandardOutputPath

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

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

-RestartOnRetry

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

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

-RestartScriptOnExitCodeReboot

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

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

-WarnAndContinueOnMatch

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

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

-WorkingDirectory

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

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

Saídas

ScriptCommandSetting

Esse cmdlet retorna um objeto ScriptCommandSetting .