Compartilhar via

New-SCScriptCommandSetting

Módulo:
VirtualMachineManager Module

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

Sintaxe

Default (Padrão) 

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 do 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 do aplicativo armazenado no $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, em seguida, armazena o objeto na variável $ScriptSetting.

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

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

-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 .