New-SCScriptCommandSetting

  • Referencia
Módulo:
VirtualMachineManager

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

Syntax

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 del comando 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 deben reiniciarse una vez que el script haya terminado de ejecutarse.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CommandMayReboot

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FailOnMatch

Indica que se produce un error en la acción realizada cuando se coincide con una directiva de error.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MatchExitCode

Especifica el código de salida de la directiva de error.

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MatchRebootExitCode

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MatchStandardError

Especifica el error estándar de la directiva de error.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MatchStandardOutput

Especifica la salida estándar de la directiva de error.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PersistStandardErrorPath

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PersistStandardOutputPath

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RestartOnRetry

Indica si se reinicia un script tras el reinicio del trabajo de VMM si el error de trabajo anterior se debe a un error de script cuando se usa junto con New-SCScriptCommandSetting o Set-SCScriptCommandSetting.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WarnAndContinueOnMatch

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WorkingDirectory

Especifica un directorio de trabajo para un comando de script.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Salidas

ScriptCommandSetting

Este cmdlet devuelve un objeto ScriptCommandSetting .