New-SCScriptCommandSetting
Crea un objeto de configuración para un comando de script.
Sintaxis
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 $ScriptSettingEl 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 del 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 deben reiniciarse siempre después de que el script haya terminado de ejecutarse.
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-CommandMayReboot
Indica que el comando de script puede reiniciar el equipo o la máquina virtual.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-FailOnMatch
Indica que se produce un error en la acción realizada cuando se hace coincidir una directiva de error.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-MatchExitCode
Especifica el código de salida de la directiva de error.
Formato de ejemplo: -MatchExitCode "[1-9][0-9]*"
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-MatchRebootExitCode
Especifica el código de salida de coincidencia de directiva de reinicio.
Formato de ejemplo: -MatchRebootExitCode "{1641}|{3010}|{3011}"
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-MatchStandardError
Especifica el error estándar de la directiva de error.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-MatchStandardOutput
Especifica la salida estándar de la directiva de error.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PersistStandardErrorPath
Especifica la ruta de acceso del archivo para almacenar el error estándar.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PersistStandardOutputPath
Especifica la ruta de acceso del archivo para almacenar la salida estándar.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-RestartOnRetry
Indica si se reinicia un script tras el reinicio del trabajo de VMM si el error del trabajo anterior se debe a un error de script cuando se usa junto con New-SCScriptCommandSetting o Set-SCScriptCommandSetting.
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-RestartScriptOnExitCodeReboot
Indica si el script se reinicia después de reiniciar el equipo o la máquina virtual cuando se coincide con un código de salida.
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-WarnAndContinueOnMatch
Indica que la acción realizada cuando se coincide una directiva de error es advertir al usuario y continuar con la operación.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-WorkingDirectory
Especifica un directorio de trabajo para un comando de script.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Salidas
ScriptCommandSetting
Este cmdlet devuelve un objeto ScriptCommandSetting.