Compartir a través de


Set-SCScriptCommandSetting

Configura una opción de comando de script.

Sintaxis

Default (Es el valor predeterminado).

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

El cmdlet Set-SCScriptCommandSetting configura una configuración de comando de script.

Ejemplos

Ejemplo 1: Actualizar el directorio de trabajo asociado con el comando de 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

El primer comando obtiene el objeto de perfil de aplicación denominado SvcWebAppProfile01 y almacena el objeto en la variable $AppProfile.

El segundo comando obtiene el comando de script denominado PreInstall para el perfil de aplicación almacenado en $AppProfile y, a continuación, almacena el objeto en la variable $ScriptCommand.

El tercer comando obtiene el objeto de configuración del comando de script para el comando de script almacenado en $ScriptCommand y almacena el objeto en la variable $ScriptCmdSetting.

El cuarto comando establece la configuración del directorio de trabajo en Working_Folder_03.

El último comando actualiza el comando de script almacenado en $ScriptCommand con la configuración almacenada en $ScriptCmdSetting.

Parámetros

-AlwaysReboot

Indica si un equipo o una máquina virtual siempre debe reiniciarse una vez que el script haya terminado de ejecutarse.

Propiedades del parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CommandMayReboot

Indica que el comando de script puede reiniciar el equipo o la máquina virtual.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-FailOnMatch

Indica que la acción que se realiza cuando se coincide con una directiva de error es para producirse un error.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MatchExitCode

Especifica el código de salida de la política de errores.

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MatchRebootExitCode

Especifica el código de salida de coincidencia de la directiva de reinicio.

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MatchStandardError

Especifica el error estándar de la política de errores.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MatchStandardOutput

Especifica la salida estándar de la política de errores.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PersistStandardErrorPath

Especifica la ruta de acceso del archivo para almacenar el error estándar.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PersistStandardOutputPath

Especifica la ruta de acceso del archivo para almacenar la salida estándar.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RestartOnRetry

Indica si un script se reinicia al reiniciar el trabajo de VMM si el error del trabajo anterior se debió a un error de script cuando se usa junto con New-SCScriptCommandSetting o Set-SCScriptCommandSetting.

Propiedades del parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RestartScriptOnExitCodeReboot

Indica si el script se reinicia después de reiniciar el equipo o la máquina virtual cuando coincide con un código de salida.

Propiedades del parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ScriptCommandSetting

Especifica un objeto de configuración de comandos de script.

Propiedades del parámetro

Tipo:SCScriptCommandSetting
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WarnAndContinueOnMatch

Indica que la acción que se realiza cuando se coincide con una directiva de error es advertir al usuario y continuar la operación.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WorkingDirectory

Especifica un directorio de trabajo para un comando de script.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Salidas

ScriptCommandSetting

Este cmdlet devuelve un objeto ScriptCommandSetting .