SQLDacApplication [SPFSDK][VMROLE]

Article
08/24/2015

S’applique à : Windows Azure Pack

L’objet SQLDacApplication fournit des paramètres pour installer SQL Server applications de la couche Données (DACs) lorsqu’une machine virtuelle Windows est approvisionnée.

Hiérarchie de types

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

Syntaxe

{
    "DeploymentName": "string",

    "ScriptCommands": [
        <Script>
    ],

    "SQLScriptCommands": [
        {
            "DatabaseName": "string",
            "DeploymentOrder": integer,
            "EncryptConnection": boolean,
            "ExecutionTimeoutSeconds": integer,
            "LoginTimeoutSeconds": integer,
            "OutputFilePath": "string",
            "SQLAuthenticationType": "string",
            "CommandParameters": "string",
            "SQLScriptApplicationPayloadId": "string",
            "ScriptCredential": credential string,
            "ScriptType": "string",
        }
    ],

    "ApplicationPayloadId": "string",
    "BlockOnChanges": boolean,
    "DacInstance": "string",
    "IgnoreDataLoss": boolean,
    "RollbackOnFailure": boolean,
    "SQLAuthenticationType": "string",

    "SQLDeploymentCredential": credential string,

    "SQLInstance": "string",
    "SkipPolicyValidation": boolean,
    "UninstallMode": "string",
}

Propriétés

Nom	Type	Obligatoire	Valeur par défaut	Description
DeploymentName	String	Oui	None	Le nom du déploiement.
ScriptCommands	Tableau de script [SPFSDK][VMROLE]	Non	null	Scripts à exécuter lors de l’approvisionnement. Les seules valeurs valides pour la propriété Script.ScriptType sont les suivantes : Préinstaller PostInstallation PreService PostService Préinstallation PostUninstall
SQLScriptCommands	Tableau de SQLScriptCommand	Non	null	Transact SQL commandes de script qui s’exécutent avec l’installation de l’application de la couche Données SQL Server.
ApplicationPayloadId	String	Oui	None	Identificateur d’un élément ApplicationProfile.ApplicationPayload . Cette charge utile doit pointer vers un fichier .sql de script Transact-SQL.
BlockOnChanges	Boolean	Non	None	Si la valeur est true, indique que la mise à niveau de l’application de la couche Données SQL Server doit échouer en cas de dérive de base de données. Pour plus d’informations, consultezhttps://go.microsoft.com/fwlink/?LinkID=307133.
DacInstance	String	Oui	None	Nom d’application de la couche Données SQL Server de l’instance de SQL Server.
IgnoreDataLoss	Boolean	Non	None	Si la valeur est true, indique qu’une erreur de perte de données doit être ignorée lors d’une mise à niveau d’application de la couche Données SQL Server. Pour plus d’informations, consultezhttps://go.microsoft.com/fwlink/?LinkID=307133.
RollbackOnFailure	Boolean	Oui	None	Si la valeur est true, indique que la base de données doit être restaurée en cas d’échec de mise à niveau. Pour plus d’informations, consultezhttps://go.microsoft.com/fwlink/?LinkID=307133.
SQLAuthenticationType	String	Oui	None	Type d’authentification utilisé pour déployer l’application de la couche Données SQL Server. Les valeurs autorisées sont : WindowsAuthentication SQLAuthentication
SQLDeploymentCredential	String	Oui	None	Informations d’identification à utiliser lors de l’installation de l’application de la couche Données SQL Server, au format domain\username:password.
SQLInstance	String	Non	MSSQLSERVER	Nom de l’instance de SQL Server sur laquelle l’application de la couche Données SQL Server doit être déployée.
SkipPolicyValidation	Boolean	Oui	None	Si la valeur est true, indique que la validation de la stratégie SQL Server doit être ignorée lorsqu’une application de la couche Données SQL Server est mise à niveau. Pour plus d’informations, consultezhttps://go.microsoft.com/fwlink/?LinkID=307133.
UninstallMode	String	Oui	None	Comportement de désinstallation de l’application de la couche Données SQL Server concernant la base de données. Les valeurs autorisées sont : MakeUnmanaged DétacheDatabase DropDatabase Pour plus d’informations, consultezhttps://go.microsoft.com/fwlink/?LinkID=307135.

SQLScriptCommand

Pour plus d’informations sur le script PowerShell Virtual Machine ManagerWindows utilisé par cette section, consultez https://go.microsoft.com/fwlink/?LinkID=218391.

Nom	Type	Obligatoire	Valeur par défaut	Description
nom_base_de_données	String	Oui	None	Nom de la base de données sur laquelle cette commande de script est exécutée.
DeploymentOrder	Int	Oui	None	Ordre dans lequel exécuter cette commande de script.
EncryptConnection	Boolean	Non	False	Si la valeur est true, indique le chiffrement de la connexion à l’instance de SQL Server.
ExecutionTimeoutSeconds	Int	Oui	None	Délai d’expiration de la commande de script, en secondes.
LoginTimeoutSeconds	Oui	Oui	None	Délai d’expiration pour établir une connexion à l’instance de SQL Server, en secondes.
OutputFilePath	String	Non	None	Chemin d’accès du fichier journal pour capturer toutes les sorties.
SQLAuthenticationType	String	Oui	None	Type d’authentification utilisé pour déployer l’application de couche données SQL Server. Les valeurs autorisées sont : WindowsAuthentication SQLAuthentication
CommandParameters	String	Non	null	Paires nom-valeur des paramètres de commande à utiliser avec la commande SQL. Pour plus d’informations, consultez le commutateur -v de la documentation de l’outil Sqlcmd à l’adresse https://go.microsoft.com/fwlink/?LinkID=154481.
SQLScriptApplicationPayloadId	String	Oui	None	Identificateur d’un élément ApplicationProfile.ApplicationPayload . Cette charge utile doit pointer vers un fichier Transact SQL script .sql.
ScriptCredential	String	Oui	None	Informations d’identification utilisées pour exécuter le script, au format domain\username:password .
ScriptType	String	Oui	None	Spécification pour laquelle le script doit être exécuté. Les valeurs autorisées sont : Préinstaller PostInstall PreService PostService Préuninstallation PostUninstall

Remarques

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

{
    "DeploymentName": "SQL App 1",

    "ScriptCommands": [
        {
            "AlwaysReboot": false,
            "ApplicationPayloadId": null,
            "ErrorPolicy": "FailOnMatch",
            "ExecutableAndParams": null,
            "ExitCodeRegex": "[1-9][0-9]*",
            "MaxOutputSize": 1048576,
            "RebootExitCodeRegex": "{1641}|{3010}|{3011}",
            "RestartOnRetry": false,
            "ScriptBlock": "rem some script that needs to run before sqldac package is installed",
            "ScriptCredential": {
                "Password": "mypassword4",
                "UserName": "dcmanagerlab\\esdcvsec4"
            },
            "ScriptType": "PreInstall",
            "StandardErrorPath": "c:\\err.txt",
            "StandardErrorRegex": ".+",
            "StandardInput": null,
            "StandardOutputPath": "c:\\out.txt",
            "StandardOutputRegex": null,
            "TimeoutInSeconds": 900,
            "WorkingDirectory": null
        }
    ],

    "SQLScriptCommands": [
        {
            "DatabaseName": "[Param.SharepointDB]",
            "DeploymentOrder": 1,
            "EncryptConnection": false,
            "ExecutionTimeoutSeconds": 500,
            "LoginTimeoutSeconds": 50,
            "OutputFilePath": "c:\\sharepointDB.sql.log",
            "SQLAuthenticationType": "WindowsAuthentication",
            "CommandParameters" : "VAR1=42 VAR2=\"Example String\"",
            "SQLScriptApplicationPayloadId": "db04416b-d0a8-44d5-b0ee-d5739378a98d",
            "ScriptCredential": "[Param.SQLScriptCommandCredential]",
            "ScriptType": "PostInstall"
        }
    ],

    "ApplicationPayloadId": "5b064b6a-d6d0-48f0-8979-9aafc676a9e5",
    "BlockOnChanges": false,
    "DacInstance": "[Param.SharepointDB]",
    "IgnoreDataLoss": false,
    "RollbackOnFailure": true,
    "SQLAuthenticationType": "WindowsAuthentication",

    "SQLDeploymentCredential": "[param.SQLDeploymentCredential]",

    "SQLInstance": "[Param.SQLInstance]",
    "SkipPolicyValidation": true,
    "UninstallMode": "DropDatabase"
}

Voir aussi

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

Partager via