Script [SPFSDK][VMROLE]

Artículo
08/24/2015

Se aplica a: Windows Azure Pack

El objeto Script representa un ejecutable de línea de comandos que se ejecuta cuando se aprovisiona una máquina virtual basada en Windows. Este objeto combina muchas de las propiedades de los siguientes cmdlets de Windows PowerShell en System Center 2012 R2 Virtual Machine Manager (VMM):

Add-SCScriptCommand
https://go.microsoft.com/fwlink/?LinkID=308898
New-SCScriptCommandSetting
https://go.microsoft.com/fwlink/?LinkID=308899
Set-SCScriptCommandSetting
https://go.microsoft.com/fwlink/?LinkID=308900

Jerarquía de tipos

ResourceExtension [SPFSDK][VMROLE]. ExtensionSettings [SPFSDK][VMROLE]. ApplicationProfile.WindowsApplicationProfile [SPFSDK][VMROLE]. Guión

Sintaxis

{
    "AlwaysReboot": false,
    "ApplicationPayloadId": string,
    "DeploymentOrder": integer,
    "ErrorPolicy": string,
    "ExecutableAndParams": {
        "Executable": string,
        "Parameters": string,
    },
    "ExitCodeRegex": string,
    "MaxOutputSize": integer,
    "RebootExitCodeRegex": regex string,
    "RestartOnRetry": boolean,
    "RestartOnExitCodeReboot": boolean,
    "ScriptBlock": string,
    "ScriptCredential": credential string
    "ScriptType": string,
    "StandardErrorPath": string,
    "StandardErrorRegex": regex string,
    "StandardInput": string,
    "StandardOutputPath": string,
    "StandardOutputRegex": regex string,
    "TimeoutInSeconds": integer,
    "WorkingDirectory": string
}

Propiedades

Nombre	Tipo	Obligatorio	Valor predeterminado	Descripción
AlwaysReboot	Boolean	No	None	Si es true, indica que se debe iniciar un reinicio después de que el script finalice correctamente.
ApplicationPayloadID	String	No	None	Identificador de un elemento ApplicationProfile.ApplicationPayload . Esta carga debe apuntar a una carpeta y puede contener el script que se va a ejecutar. Esta propiedad no se usa cuando la propiedad ScriptType se establece en uno de los valores siguientes: OnDeleteLast OnDeleteRest
DeploymentOrder	Int	No	None	Orden en el que se va a ejecutar este comando de script. Esta propiedad solo se usa cuando la propiedad ScriptType se establece en uno de los siguientes valores: Preinstalar OnProvisionFirst OnProvisionLast
ErrorPolicy	String	Sí	None	Directiva que controla un error devuelto por el código de salida del script. Los valores permitidos son: FailOnMatch WarnAndContinueOnMatch
EjecutableAndParams	EjecutableAndParams	Es posible	None	Ejecutable que se va a ejecutar. Esta propiedad o la propiedad ScriptBlock deben declararse, pero nunca ambas.
ExitCodeRegEx	String	No	[1-9] [0-9]*	Expresión regular que se usa para determinar los códigos de salida de error del script.
RebootExitCodeRegEx	String	No	None	Expresión regular que se usa para determinar los códigos de salida de reinicio del script.
RestartOnRetry	Boolean	Sí	None	Si es true, indica que este script se puede volver a ejecutar cuando se ejecuta la aplicación primaria después de que se produzca un error en este script y se repare la máquina virtual.
RestartOnExitCodeReboot	Boolean	No	None	Si es true, indica que el script debe volver a ejecutarse después de reiniciar la máquina. El script reinicia la máquina cuando el código de salida coincide con los códigos de salida especificados por la propiedad RebootExitCodeRegEx .
Bloque de script	String	Es posible	None	Comandos de script de shell Windows insertados. Esta propiedad o la propiedad ExecutableAndParams deben declararse, pero nunca ambas.
ScriptCredential	String	No	None	Credencial que se va a usar cuando se ejecuta el script, en un formato domain\username:password .
ScriptType	String	Sí	None	Determina cuándo se ejecuta este script. Se admiten los valores siguientes: Preinstalar PostInstall PreUninstall PostUninstall OnProvisionFirst OnProvisionRest OnDeleteLast OnDeleteRest Los script Pre* y Post* ScriptTypes siguen la semántica de comandos de script de Virtual Machine Manager AppProfile-Level System Center 2012 R2. OnProvision* ScriptTypes sigue la semántica del comando de script De aprovisionamiento asimétrico.
StandardErrorPath	String	No	None	Ruta de acceso a un archivo que se debe usar para capturar la secuencia stderr .
StandardErrorRegex	String	No	None	Expresión regular que se compara con el flujo stderr de los errores.
StandardInput	String	No	None	Cadena que se va a pasar al flujo stdin cuando se ejecuta el script.
StandardOutputPath	String	No	None	Ruta de acceso a un archivo que se debe usar para capturar la secuencia stdout .
StandardOutputRegex	String	No	None	Expresión regular que se compara con el flujo stdout de los errores.
TimeoutInSeconds	Int	Sí	None	Número de segundos que se esperarán hasta que se agote el tiempo de espera.
WorkingDirectory	String	No	Directorio del sistema de Windows	Directorio de trabajo que se va a establecer para el proceso creado por este objeto Script .

ExecutableAndParams

Para obtener más información sobre el cmdlet Windows PowerShell Add-SCScriptCommand en Virtual Machine Manager que usa esta sección, vea https://go.microsoft.com/fwlink/?LinkID=308898.

Nombre	Tipo	Obligatorio	Valor predeterminado	Descripción
Ejecutable	String	Sí	None	Ejecutable que se va a ejecutar.
Parámetros	String	Sí	None	Parámetros que se van a pasar al ejecutable.

Comentarios

En el ejemplo de código siguiente se proporciona un objeto Script de ejemplo.

{
    "AlwaysReboot": false,
    "ApplicationPayloadId": "49c1ccdb-9068-4b91-9409-0a7ca8a1d291",
    "DeploymentOrder": 1,
    "ErrorPolicy": "FailOnMatch",
    "ExecutableAndParams": {
        "Executable": "cmd.exe",
        "Parameters": "/q /c msiexec sharepoint.msi"
    },
    "ExitCodeRegex": "[1-9][0-9]*",
    "MaxOutputSize": 1048576,
    "RebootExitCodeRegex": "{1641}|{3010}|{3011}",
    "RestartOnRetry": false,
    "ScriptBlock": null,
    "ScriptCredential": "domain\\user:password",
    "ScriptType": "PreInstall",
    "StandardErrorPath": "c:\\err.txt",
    "StandardErrorRegex": ".+",
    "StandardInput": null,
    "StandardOutputPath": "c:\\out.txt",
    "StandardOutputRegex": null,
    "TimeoutInSeconds": 900,
    "WorkingDirectory": null
}

Consulte también

ApplicationProfile.WindowsApplicationProfile [SPFSDK][VMROLE]
SQLProfile [SPFSDK][VMROLE]
WebDeployApplication [SPFSDK][VMROLE]
SQLDacApplication [SPFSDK][VMROLE]
ScriptApplication [SPFSDK][VMROLE]

Compartir a través de