Script [SPFSDK][VMROLE]

Article
08/24/2015

S’applique à : Windows Azure Pack

L’objet Script représente un exécutable de ligne de commande exécuté lorsqu’une machine virtuelle Windows est approvisionnée. Cet objet combine de nombreuses propriétés des applets de commande Windows PowerShell suivantes dans 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

Hiérarchie des types

ResourceExtension [SPFSDK][VMROLE]. ExtensionSettings [SPFSDK][VMROLE]. ApplicationProfile.WindowsApplicationProfile [SPFSDK][VMROLE]. Script

Syntaxe

{
    "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
}

Propriétés

Nom	Type	Obligatoire	Valeur par défaut	Description
AlwaysReboot	Boolean	Non	None	Si la valeur est true, indique qu’un redémarrage doit être lancé une fois le script terminé avec succès.
ApplicationPayloadID	String	Non	None	Identificateur d’un élément ApplicationProfile.ApplicationPayload . Cette charge utile doit pointer vers un dossier et peut contenir le script à exécuter. Cette propriété n’est pas utilisée lorsque la propriété ScriptType est définie sur l’une des valeurs suivantes : OnDeleteLast OnDeleteRest
DeploymentOrder	Int	Non	None	Ordre dans lequel exécuter cette commande de script. Cette propriété est utilisée uniquement lorsque la propriété ScriptType est définie sur l’une des valeurs suivantes : Préinstaller OnProvisionFirst OnProvisionLast
ErrorPolicy	String	Oui	None	Stratégie qui gère une erreur retournée par le code de sortie du script. Les valeurs autorisées sont les suivantes : FailOnMatch WarnAndContinueOnMatch
ExécutableAndParams	ExécutableAndParams	Peut-être	None	Exécutable à exécuter. Cette propriété ou la propriété ScriptBlock doit être déclarée, mais jamais les deux.
ExitCodeRegEx	String	Non	[1-9] [0-9]*	Expression régulière utilisée pour déterminer les codes de sortie d’erreur du script.
RebootExitCodeRegEx	String	Non	None	Expression régulière utilisée pour déterminer les codes de sortie de redémarrage du script.
RestartOnRetry	Boolean	Oui	None	Si la valeur est true, indique que ce script peut être réexécuté lorsque l’application parente est exécutée après l’échec de ce script et que la machine virtuelle est réparée.
RestartOnExitCodeReboot	Boolean	Non	None	Si la valeur est true, indique que le script doit être réexécuté après le redémarrage de l’ordinateur. Le script redémarre l’ordinateur lorsque le code de sortie correspond aux codes de sortie spécifiés par la propriété RebootExitCodeRegEx .
ScriptBlock	String	Peut-être	None	Commandes de script d’interpréteur de commandes inline Windows. Cette propriété ou la propriété ExécutableAndParams doit être déclarée, mais jamais les deux.
ScriptCredential	String	Non	None	Informations d’identification à utiliser lorsque le script est exécuté, au format domain\username:password .
ScriptType	String	Oui	None	Détermine quand ce script s’exécute. Les valeurs autorisées sont les suivantes : Préinstaller PostInstall Préuninstallation PostUninstall OnProvisionFirst OnProvisionRest OnDeleteLast OnDeleteRest Les scripts Pre* et Post* suivent la sémantique de commande de script System Center 2012 R2 Virtual Machine Manager AppProfile-Level. Les scripts OnProvision* suivent la sémantique de commande de script d’approvisionnement asymétrique.
StandardErrorPath	String	Non	None	Chemin d’accès à un fichier qui doit être utilisé pour capturer le flux stderr .
StandardErrorRegex	String	Non	None	Expression régulière comparée au flux stderr pour les erreurs.
StandardInput	String	Non	None	Chaîne à transmettre au flux stdin lorsque le script est exécuté.
StandardOutputPath	String	Non	None	Chemin d’accès à un fichier qui doit être utilisé pour capturer le flux stdout .
StandardOutputRegex	String	Non	None	Expression régulière comparée au flux stdout pour les erreurs.
TimeoutInSeconds	Int	Oui	None	Nombre de secondes à attendre jusqu’à ce qu’un délai d’expiration se produise.
WorkingDirectory	String	Non	répertoire système Windows	Répertoire de travail à définir pour le processus créé par cet objet Script .

ExécutableAndParams

Pour plus d’informations sur l’applet de commande Windows PowerShell Add-SCScriptCommand dans Virtual Machine Manager qui est utilisée par cette section, consultez https://go.microsoft.com/fwlink/?LinkID=308898.

Nom	Type	Obligatoire	Valeur par défaut	Description
Exécutable	String	Oui	None	Exécutable à exécuter.
Paramètres	String	Oui	None	Paramètres à transmettre à l’exécutable.

Remarques

L’exemple de code suivant fournit un exemple d’objet Script .

{
    "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
}

Voir aussi

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

Partager via