Script [SPFSDK][VMROLE]

Artigo
08/24/2015

Aplica-se a: Windows Azure Pack

O objeto Script representa um executável de linha de comando executado quando uma máquina virtual baseada em Windows é provisionada. Esse objeto combina muitas das propriedades dos seguintes cmdlets de Windows PowerShell em 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

Hierarquia de Tipos

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

Sintaxe

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

Propriedades

Nome	Tipo	Obrigatório	Valor padrão	Descrição
AlwaysReboot	Boolean	Não	Nenhum	Se verdadeiro, indica que uma reinicialização deve ser iniciada após o término do script com êxito.
ApplicationPayloadID	String	Não	Nenhum	O identificador de um item ApplicationProfile.ApplicationPayload . Essa carga deve apontar para uma pasta e pode conter o script a ser executado. Essa propriedade não é usada quando a propriedade ScriptType é definida como um dos seguintes valores: OnDeleteLast OnDeleteRest
DeploymentOrder	int	Não	Nenhum	A ordem na qual executar esse comando de script. Essa propriedade só é usada quando a propriedade ScriptType é definida como um dos seguintes valores: Pré-instalar OnProvisionFirst OnProvisionLast
ErrorPolicy	String	Sim	Nenhum	A política que manipula um erro retornado pelo código de saída do script. Os valores permitidos são: FailOnMatch WarnAndContinueOnMatch
ExecutableAndParams	ExecutableAndParams	Talvez	Nenhum	O executável a ser executado. Essa propriedade ou a propriedade ScriptBlock devem ser declaradas, mas nunca ambas.
ExitCodeRegEx	String	Não	[1-9] [0-9]*	Uma expressão regular que é usada para determinar códigos de saída de erro do script.
RebootExitCodeRegEx	String	Não	Nenhum	Uma expressão regular que é usada para determinar a reinicialização dos códigos de saída do script.
RestartOnRetry	Boolean	Sim	Nenhum	Se for verdadeiro, indica que esse script pode ser executado novamente quando o aplicativo pai for executado depois que esse script falhar e a máquina virtual for reparada.
RestartOnExitCodeReboot	Boolean	Não	Nenhum	Se verdadeiro, indica que o script deve ser executado novamente após a reinicialização do computador. O script reinicializa o computador quando o código de saída corresponde aos códigos de saída especificados pela propriedade RebootExitCodeRegEx .
Bloco de script	String	Talvez	Nenhum	Comandos de script de shell Windows embutidos. Essa propriedade ou a propriedade ExecutableAndParams devem ser declaradas , mas nunca ambas.
ScriptCredential	String	Não	Nenhum	A credencial a ser usada quando o script é executado, em um formato domain\username:password .
ScriptType	String	Sim	Nenhum	Determina quando esse script é executado. Os seguintes valores são permitidos: Pré-instalar PostInstall Pré-instalação PostUninstall OnProvisionFirst OnProvisionRest OnDeleteLast OnDeleteRest Os ScriptTypes Pre* e Post* seguem a semântica de comando de script System Center Nível de Virtual Machine Manager AppProfile 2012 R2. Os ScriptTypes OnProvision* seguem a semântica de comando de script de Provisionamento Assimétrico.
StandardErrorPath	String	Não	Nenhum	O caminho para um arquivo que deve ser usado para capturar o fluxo stderr .
StandardErrorRegex	String	Não	Nenhum	Uma expressão regular que é comparada com o fluxo stderr para erros.
Standardinput	String	Não	Nenhum	Uma cadeia de caracteres para passar para o fluxo de stdin quando o script for executado.
StandardOutputPath	String	Não	Nenhum	O caminho para um arquivo que deve ser usado para capturar o fluxo stdout .
StandardOutputRegex	String	Não	Nenhum	Uma expressão regular que é comparada com o fluxo stdout para erros.
TimeoutInSeconds	int	Sim	Nenhum	O número de segundos a aguardar até que ocorra um tempo limite.
WorkingDirectory	String	Não	Windows Diretório do Sistema	O diretório de trabalho a ser definido para o processo criado por esse objeto Script .

ExecutableAndParams

Para obter mais informações sobre o cmdlet Windows PowerShell Add-SCScriptCommand em Virtual Machine Manager que é usado por esta seção, consulte https://go.microsoft.com/fwlink/?LinkID=308898.

Nome	Tipo	Obrigatório	Valor padrão	Descrição
Executável	String	Sim	Nenhum	O executável a ser executado.
Parâmetros	String	Sim	Nenhum	Os parâmetros a serem passados para o executável.

Comentários

O exemplo de código a seguir fornece um objeto Script de exemplo.

{
    "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 Também

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

Compartilhar via