Partilhar via

New-SCScriptCommandSetting

Módulo:
VirtualMachineManager Module

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

Sintaxe

Default (Predefiniçã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 settings para um comando 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 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 que o comando script armazenado em $ScriptCommand seja 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 dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-CommandMayReboot

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-FailOnMatch

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-MatchExitCode

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

Exemplo de formato: -MatchExitCode "[1-9][0-9]*"

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-MatchRebootExitCode

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

Exemplo de formato: -MatchRebootExitCode "{1641}|{3010}|{3011}"

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-MatchStandardError

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-MatchStandardOutput

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PersistStandardErrorPath

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PersistStandardOutputPath

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RestartOnRetry

Indica se um script é reiniciado após a 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 dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WorkingDirectory

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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

Este cmdlet retorna um objeto ScriptCommandSetting .