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 .