Compartir a través de


New-SCScriptCommandSetting

Crea un objeto de configuración para un comando de script.

Sintaxis

Default (Es el valor predeterminado).

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

El cmdlet New-SCScriptCommandSetting crea un objeto de configuración para un comando de script.

Ejemplos

Ejemplo 1: Agregar una configuración de directorio de trabajo a un 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

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 objeto de comando de script denominado PostInstall para el perfil de aplicación almacenado en $AppProfile.

El tercer comando crea una nueva configuración de comando de script que establece el directorio de trabajo en Working_Folder_02 y, a continuación, almacena el objeto en la variable $ScriptSetting.

El último comando actualiza el directorio de trabajo para el comando de script almacenado en $ScriptCommand que se va a Working_Folder_02 (el valor de $ScriptSetting).

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

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