Partager via

Schéma WorkerRole de définition d’Azure Cloud Services (classique)

  • Article

Important

Cloud Services (classique) est désormais déconseillé pour tous les clients depuis le 1er septembre 2024. Tous les déploiements existants en cours d’exécution seront arrêtés par Microsoft, et les données seront définitivement perdues à partir d’octobre 2024. Les nouveaux déploiements doivent utiliser le nouveau modèle de déploiement basé sur Azure Resource Manager Azure Cloud Services (support étendu) .

Le rôle de travail Azure est un rôle utile pour le développement généralisé. Il peut également effectuer le traitement en arrière-plan pour un rôle Web.

L’extension par défaut du fichier de définition de service est .csdef.

Schéma de définition de service de base pour un rôle de travail.

Le format de base du fichier de définition de service contenant un rôle de travail est le suivant.

<ServiceDefinition …>
  <WorkerRole name="<worker-role-name>" vmsize="<worker-role-size>" enableNativeCodeExecution="[true|false]">
    <Certificates>
      <Certificate name="<certificate-name>" storeLocation="[CurrentUser|LocalMachine]" storeName="[My|Root|CA|Trust|Disallow|TrustedPeople|TrustedPublisher|AuthRoot|AddressBook|<custom-store>" />
    </Certificates>
    <ConfigurationSettings>
      <Setting name="<setting-name>" />
    </ConfigurationSettings>
    <Endpoints>
      <InputEndpoint name="<input-endpoint-name>" protocol="[http|https|tcp|udp]" localPort="<local-port-number>" port="<port-number>" certificate="<certificate-name>" loadBalancerProbe="<load-balancer-probe-name>" />
      <InternalEndpoint name="<internal-endpoint-name" protocol="[http|tcp|udp|any]" port="<port-number>">
         <FixedPort port="<port-number>"/>
         <FixedPortRange min="<minimum-port-number>" max="<maximum-port-number>"/>
      </InternalEndpoint>
     <InstanceInputEndpoint name="<instance-input-endpoint-name>" localPort="<port-number>" protocol="[udp|tcp]">
         <AllocatePublicPortFrom>
            <FixedPortRange min="<minimum-port-number>" max="<maximum-port-number>"/>
         </AllocatePublicPortFrom>
      </InstanceInputEndpoint>
    </Endpoints>
    <Imports>
      <Import moduleName="[RemoteAccess|RemoteForwarder|Diagnostics]"/>
    </Imports>
    <LocalResources>
      <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />
    </LocalResources>
    <LocalStorage name="<local-store-name>" cleanOnRoleRecycle="[true|false]" sizeInMB="<size-in-megabytes>" />
    <Runtime executionContext="[limited|elevated]">
      <Environment>
         <Variable name="<variable-name>" value="<variable-value>">
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>
          </Variable>
      </Environment>
      <EntryPoint>
         <NetFxEntryPoint assemblyName="<name-of-assembly-containing-entrypoint>" targetFrameworkVersion="<.net-framework-version>"/>
         <ProgramEntryPoint commandLine="<application>" setReadyOnProcessStart="[true|false]"/>
      </EntryPoint>
    </Runtime>
    <Startup priority="<for-internal-use-only>">
      <Task commandLine="" executionContext="[limited|elevated]" taskType="[simple|foreground|background]">
        <Environment>
         <Variable name="<variable-name>" value="<variable-value>">
            <RoleInstanceValue xpath="<xpath-to-role-environment-settings>"/>
          </Variable>
        </Environment>
      </Task>
    </Startup>
    <Contents>
      <Content destination="<destination-folder-name>" >
        <SourceDirectory path="<local-source-directory>" />
      </Content>
    </Contents>
  </WorkerRole>
</ServiceDefinition>

Éléments du schéma

Le fichier de définition de service inclut ces éléments, qui sont détaillés dans les sections suivantes de cet article :

WorkerRole

ConfigurationSettings

Paramètre

LocalResources

LocalStorage

Points de terminaison

InputEndpoint

InternalEndpoint

InstanceInputEndpoint

AllocatePublicPortFrom

FixedPort

FixedPortRange

Certificates

Certificate

Importations

Importer

Runtime

Environment

EntryPoint

NetFxEntryPoint

ProgramEntryPoint

Variable

RoleInstanceValue

Startup

Tâche

Contents

Contenu

SourceDirectory

WorkerRole

L’élément WorkerRole décrit un rôle utile pour le développement généralisé. Il peut également effectuer le traitement en arrière-plan pour un rôle Web. Un service peut contenir zéro ou plusieurs rôles de travail.

Le tableau suivant décrit les attributs d’un de l’élément WorkerRole.

Attribut Type Description
name string Obligatoire. Nom du rôle de travail. Le nom du rôle doit être unique.
enableNativeCodeExecution boolean facultatif. La valeur par défaut est true ; les fonctions d’exécution du code natif et de confiance totale sont activées par défaut. Définissez cet attribut sur false pour désactiver l’exécution du code natif pour le rôle de travail et utilisez à la place la fonction de confiance totale Azure.
vmSize string facultatif. Définissez cette valeur pour modifier la taille de la machine virtuelle allouée à ce rôle. La valeur par défaut est Small. Pour obtenir la liste des tailles de machine virtuelle possibles et leurs attributs, consultez Tailles de machine virtuelle pour les services cloud.

ConfigurationSettings

L’élément ConfigurationSettings décrit la collection de paramètres de configuration pour un rôle de travail. Cet élément est le parent de l’élément Setting.

Paramètre

L’élément Setting décrit une paire nom-valeur qui spécifie un paramètre de configuration pour une instance d’un rôle.

Le tableau suivant décrit les attributs d’un de l’élément Setting.

Attribut Type Description
name string Obligatoire. Nom unique du paramètre de configuration.

Les paramètres de configuration d’un rôle sont des paires nom-valeur déclarées dans le fichier de définition de service et définies dans le fichier de configuration de service.

LocalResources

L’élément LocalResources décrit la collection de ressources de stockage local pour un rôle de travail. Cet élément est le parent de l’élément LocalStorage.

LocalStorage

L’élément LocalStorage identifie une ressource de stockage local qui fournit l’espace de système de fichiers pour le service lors de l’exécution. Un rôle peut définir zéro ou plusieurs ressources de stockage local.

Notes

L’élément LocalStorage peut apparaître en tant qu’enfant de l’élément WorkerRole pour prendre en charge la compatibilité avec les versions antérieures du kit SDK Azure.

Le tableau suivant décrit les attributs d’un de l’élément LocalStorage.

Attribut Type Description
name string Obligatoire. Nom unique du magasin local.
cleanOnRoleRecycle boolean facultatif. Indique si le magasin local doit être nettoyé lorsque le rôle est redémarré. La valeur par défaut est true.
sizeInMb int facultatif. Quantité souhaitée d’espace de stockage à allouer pour le magasin local, en Mo. S’il n’est pas spécifié, l’espace de stockage alloué par défaut est de 100 Mo. La quantité d’espace de stockage minimale pouvant être allouée est de 1 Mo.

La taille maximale des ressources locales dépend de la taille de la machine virtuelle. Pour plus d’informations, consultez Tailles de machine virtuelle pour les services cloud.

Le nom du répertoire alloué à la ressource de stockage local correspond à la valeur fournie pour l’attribut name.

Points de terminaison

L’élément Endpoints décrit la collection de points de terminaison d’entrée (externes), internes et d’entrée d’instance pour un rôle. Cet élément est le parent des éléments InputEndpoint, InternalEndpoint et InstanceInputEndpoint.

Les points de terminaison d’entrée et internes sont alloués séparément. Un service peut avoir un total de 25 points de terminaison d’entrée d’instance, internes et d’entrée qui peuvent être alloués aux 25 rôles autorisés dans un service. Par exemple, si vous avez cinq rôles, vous pouvez allouer cinq points de terminaison d’entrée par rôle, ou 25 points de terminaison d’entrée à un seul rôle ou encore un point de terminaison d’entrée à chacun des 25 rôles.

Remarque

Chaque rôle déployé nécessite une instance par rôle. L’approvisionnement par défaut d’un abonnement est limité à 20 cœurs, et donc à 20 instances d’un rôle. Si votre application nécessite plus d’instances que ce qui est fourni par l’approvisionnement par défaut, consultez Support pour la facturation, la gestion des abonnements et les quotas pour obtenir plus d’informations sur l’augmentation de votre quota.

InputEndpoint

L’élément InputEndpoint décrit un point de terminaison externe à un rôle de travail.

Vous pouvez définir plusieurs points de terminaison combinant à la fois des points de terminaison HTTP, HTTPS, UDP et TCP. Vous pouvez spécifier le numéro de port de votre choix pour un point de terminaison d’entrée, mais les numéros de port précisés pour chaque rôle dans le service doivent être uniques. Par exemple, si vous spécifiez qu’un rôle utilise le port 80 pour HTTP et le port 443 pour HTTPS, vous pouvez ensuite spécifier qu’un deuxième rôle utilise le port 8080 pour HTTP et le port 8043 pour HTTPS.

Le tableau suivant décrit les attributs d’un de l’élément InputEndpoint.

Attribut Type Description
name string Obligatoire. Nom unique du point de terminaison externe.
protocol string Obligatoire. Protocole de transport du point de terminaison externe. Pour un rôle de travail, les valeurs possibles sont HTTP, HTTPS, UDP ou TCP.
port int Obligatoire. Port du point de terminaison externe. Vous pouvez spécifier le numéro de port de votre choix, mais les numéros de port précisés pour chaque rôle dans le service doivent être uniques.

Les valeurs possibles sont comprises entre 1 et 65535 inclus (Kit SDK Azure version 1.7 ou supérieure).
certificat string Obligatoire pour un point de terminaison HTTPS. Nom d’un certificat défini par un élément Certificate.
localPort int facultatif. Spécifie le port utilisé pour les connexions internes sur le point de terminaison. L’attribut localPort mappe le port externe sur le point de terminaison à un port interne sur un rôle. Cet attribut est utile dans les scénarios où un rôle doit communiquer avec un composant interne sur un port différent de celui qui est exposé en externe.

Si elle n’est pas spécifiée, la valeur de localPort est la même que celle de l’attribut port. Définissez la valeur de localPort sur « * » pour attribuer automatiquement un port non alloué, détectable à l’aide de l’API d’exécution.

Les valeurs possibles sont comprises entre 1 et 65535 inclus (Kit SDK Azure version 1.7 ou supérieure).

L’attribut localPort n’est disponible que par le biais du kit SDK Azure version 1.3 ou supérieure.
ignoreRoleInstanceStatus boolean facultatif. Lorsque la valeur de cet attribut est définie sur true, l’état d’un service est ignoré et l’équilibreur de charge ne supprime pas le point de terminaison. Définir cette valeur sur true est utile pour déboguer les instances occupées d’un service. La valeur par défaut est false. Remarque : un point de terminaison peut quand même recevoir le trafic, même lorsque le rôle n’est pas à l’état Prêt.
loadBalancerProbe string facultatif. Nom de la sonde de l’équilibreur de charge associée au point de terminaison d’entrée. Pour plus d’informations, consultez Schéma LoadBalancerProbe.

InternalEndpoint

L’élément InternalEndpoint décrit un point de terminaison interne à un rôle de travail. Un point de terminaison interne n’est disponible que pour les autres instances de rôle en cours d’exécution dans le service ; il n’est pas disponible pour les clients en dehors du service. Un rôle de travail peut avoir jusqu'à cinq points de terminaison internes HTTP, UDP ou TCP.

Le tableau suivant décrit les attributs d’un de l’élément InternalEndpoint.

Attribut Type Description
name string Obligatoire. Nom unique du point de terminaison interne.
protocol string Obligatoire. Protocole de transport du point de terminaison interne. Les valeurs possibles sont HTTP, TCP, UDP ou ANY.

La valeur ANY spécifie que tous les protocoles et tous les ports sont autorisés.
port int facultatif. Port utilisé pour les connexions internes à charge équilibrée sur le point de terminaison. Un point de terminaison à charge équilibrée utilise deux ports. le port utilisé pour l’adresse IP publique, et le port utilisé sur l’adresse IP privée. Ces valeurs sont généralement définies sur le même port, mais vous pouvez utiliser des ports différents.

Les valeurs possibles sont comprises entre 1 et 65535 inclus (Kit SDK Azure version 1.7 ou supérieure).

L’attribut Port n’est disponible que par le biais du kit SDK Azure version 1.3 ou supérieure.

InstanceInputEndpoint

L’élément InstanceInputEndpoint décrit un point de terminaison d’entrée d’instance à un rôle de travail. Un point de terminaison d’entrée d’instance est associé à une instance de rôle spécifique à l’aide du réacheminement de port dans l’équilibreur de charge. Chaque point de terminaison d’entrée d’instance est mappé à un port spécifique à partir d’une plage de ports possibles. Cet élément est le parent de l’élément AllocatePublicPortFrom.

L’élément InstanceInputEndpoint n’est disponible que par le biais du kit SDK Azure version 1.7 ou supérieure.

Le tableau suivant décrit les attributs d’un de l’élément InstanceInputEndpoint.

Attribut Type Description
name string Obligatoire. Nom unique du point de terminaison.
localPort int Obligatoire. Spécifie le port interne que toutes les instances de rôle écoutent pour recevoir le trafic entrant transféré depuis l’équilibreur de charge. Les valeurs possibles sont comprises entre 1 et 65535 inclus.
protocol string Obligatoire. Protocole de transport du point de terminaison interne. Les valeurs possibles sont udp ou tcp. Utilisez tcp pour le trafic http/https.

AllocatePublicPortFrom

L’élément AllocatePublicPortFrom décrit la plage de ports publics que peuvent utiliser les clients externes pour accéder à chaque point de terminaison d’entrée d’instance. Le numéro de port public (adresse IP virtuelle) est alloué à partir de cette plage, et affecté à chaque point de terminaison d’instance de rôle individuel pendant le déploiement et la mise à jour du locataire. Cet élément est le parent de l’élément FixedPortRange.

L’élément AllocatePublicPortFrom n’est disponible que par le biais du kit SDK Azure version 1.7 ou supérieure.

FixedPort

L’élément FixedPort spécifie le port du point de terminaison interne, ce qui permet les connexions à charge équilibrée sur le point de terminaison.

L’élément FixedPort n’est disponible que par le biais du kit SDK Azure version 1.3 ou supérieure.

Le tableau suivant décrit les attributs d’un de l’élément FixedPort.

Attribut Type Description
port int Obligatoire. Port du point de terminaison interne. Cet attribut a le même effet que de définir la plage FixedPortRange minimale et maximale sur le même port.

Les valeurs possibles sont comprises entre 1 et 65535 inclus (Kit SDK Azure version 1.7 ou supérieure).

FixedPortRange

L’élément FixedPortRange spécifie la plage de ports affectés au point de terminaison interne ou au point de terminaison d’entrée d’instance, et définit le port utilisé pour les connexions à charge équilibrée sur le point de terminaison.

Notes

L’élément FixedPortRange fonctionne différemment selon l’élément dans lequel il se trouve. Lorsque l’élément FixedPortRange se trouve dans l’élément InternalEndpoint, il ouvre tous les ports sur l’équilibreur de charge dans la plage des attributs min et max pour toutes les machines virtuelles sur lesquelles le rôle s’exécute. Lorsque l’élément FixedPortRange se trouve dans l’élément InstanceInputEndpoint, il ouvre seulement un port dans la plage des attributs min et max sur chaque machine virtuelle exécutant le rôle.

L’élément FixedPortRange n’est disponible que par le biais du kit SDK Azure version 1.3 ou supérieure.

Le tableau suivant décrit les attributs d’un de l’élément FixedPortRange.

Attribut Type Description
min int Obligatoire. Port minimal dans la plage. Les valeurs possibles sont comprises entre 1 et 65535 inclus (Kit SDK Azure version 1.7 ou supérieure).
max string Obligatoire. Port maximal dans la plage. Les valeurs possibles sont comprises entre 1 et 65535 inclus (Kit SDK Azure version 1.7 ou supérieure).

Certificats

L’élément Certificates décrit la collection de certificats pour un rôle de travail. Cet élément est le parent de l’élément Certificate. Un rôle peut avoir n’importe quel nombre de certificats associés. Pour plus d’informations sur l’utilisation de l’élément certificates, consultez Modifier le fichier de définition de service avec un certificat.

Certificat

L’élément Certificate décrit un certificat associé à un rôle de travail.

Le tableau suivant décrit les attributs d’un de l’élément Certificate.

Attribut Type Description
name string Obligatoire. Nom de ce certificat, utilisé pour y faire référence quand il est associé à un élément InputEndpoint HTTPS.
storeLocation string Obligatoire. Emplacement du magasin de certificats dans lequel se trouve ce certificat sur la machine locale. Les valeurs possibles sont CurrentUser et LocalMachine.
storeName string Obligatoire. Nom du magasin de certificats dans lequel se trouve ce certificat sur la machine locale. Les valeurs possibles comprennent les noms de magasin intégrés My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, ou un nom de magasin personnalisé. Si un nom de magasin personnalisé est indiqué, le magasin est automatiquement créé.
permissionLevel string facultatif. Spécifie les autorisations d’accès données aux processus de rôle. Si vous souhaitez que seuls les processus élevés puissent accéder à la clé privée, spécifiez l’autorisation elevated. Une autorisation limitedOrElevated permet à tous les processus de rôle d’accéder à la clé privée. Les valeurs possibles sont limitedOrElevated ou elevated. La valeur par défaut est limitedOrElevated.

Importations

L’élément Imports décrit une collection de modules d’importation pour un rôle de travail qui ajoutent des composants au système d’exploitation invité. Cet élément est le parent de l’élément Import. Cet élément est facultatif, et un rôle ne peut avoir qu’un seul bloc runtime.

L’élément Imports n’est disponible que par le biais du kit SDK Azure version 1.3 ou supérieure.

Importer

L’élément Import spécifie un module à ajouter au système d’exploitation invité.

L’élément Import n’est disponible que par le biais du kit SDK Azure version 1.3 ou supérieure.

Le tableau suivant décrit les attributs d’un de l’élément Import.

Attribut Type Description
moduleName string Obligatoire. Nom du module à importer. Les modules d’importation valides sont les suivants :

– RemoteAccess
– RemoteForwarder
– Diagnostics

Les modules RemoteAccess et RemoteForwarder vous permettent de configurer votre instance de rôle pour les connexions Bureau à distance. Pour plus d’informations, consultez Activer la connexion Bureau à distance.

Le module Diagnostics vous permet de collecter des données de diagnostic pour une instance de rôle.

Runtime

L’élément Runtime décrit une collection de paramètres de variables d’environnement pour un rôle de travail qui contrôlent l’environnement d’exécution du processus hôte Azure. Cet élément est le parent de l’élément Environment. Cet élément est facultatif, et un rôle ne peut avoir qu’un seul bloc runtime.

L’élément Runtime n’est disponible que par le biais du kit SDK Azure version 1.3 ou supérieure.

Le tableau suivant décrit les attributs de l’élément Runtime :

Attribut Type Description
executionContext string facultatif. Spécifie le contexte dans lequel le processus de rôle est lancé. Le contexte par défaut est limited.

- limited – Le processus est lancé sans privilèges d’administrateur.
- elevated – Le processus est lancé avec des privilèges d’administrateur.

Environnement

L’élément Environment décrit une collection de paramètres de variables d'environnement pour un rôle de travail. Cet élément est le parent de l’élément Variable. Un rôle peut avoir n’importe quel nombre de variables d’environnement définies.

Variable

L’élément Variable spécifie une variable d’environnement à définir dans le système d’exploitation invité.

L’élément Variable n’est disponible que par le biais du kit SDK Azure version 1.3 ou supérieure.

Le tableau suivant décrit les attributs de l’élément Variable :

Attribut Type Description
name string Obligatoire. Nom de la variable d'environnement à définir.
value string facultatif. Valeur à définir pour la variable d’environnement. Vous devez inclure un attribut value ou un élément RoleInstanceValue.

RoleInstanceValue

L’élément RoleInstanceValue spécifie l’attribut xPath à partir duquel récupérer la valeur de la variable.

Le tableau suivant décrit les attributs d’un de l’élément RoleInstanceValue.

Attribut Type Description
xpath string facultatif. Chemin de l’emplacement des paramètres de déploiement pour l’instance. Pour plus d’informations, consultez Variables de configuration avec XPath.

Vous devez inclure un attribut value ou un élément RoleInstanceValue.

EntryPoint

L’élément EntryPoint spécifie le point d’entrée d’un rôle. Cet élément est le parent des éléments NetFxEntryPoint. Ces éléments vous permettent de spécifier une autre application que l’application par défaut WaWorkerHost.exe pour agir comme point d’entrée du rôle.

L’élément EntryPoint n’est disponible que par le biais du kit SDK Azure version 1.5 ou supérieure.

NetFxEntryPoint

L’élément NetFxEntryPoint spécifie le programme à exécuter pour un rôle.

Notes

L’élément NetFxEntryPoint n’est disponible que par le biais du kit SDK Azure version 1.5 ou supérieure.

Le tableau suivant décrit les attributs d’un de l’élément NetFxEntryPoint.

Attribut Type Description
assemblyName string Obligatoire. Chemin et nom de fichier de l’assembly contenant le point d’entrée. Le chemin d’accès est lié au dossier \%ROLEROOT%\Approot (ne spécifiez pas \%ROLEROOT%\Approot dans la ligne de commande, c’est implicite). %ROLEROOT% est une variable d’environnement gérée par Azure, qui représente l’emplacement du dossier racine de votre rôle. Le dossier \%ROLEROOT%\Approot représente le dossier d'application de votre rôle.
targetFrameworkVersion string Obligatoire. La version de .NET framework sur laquelle l’assembly a été créé. Par exemple : targetFrameworkVersion="v4.0".

ProgramEntryPoint

L’élément ProgramEntryPoint spécifie le programme à exécuter pour un rôle. L’élément ProgramEntryPoint vous permet de spécifier un point d’entrée de programme qui n’est pas basé sur un assembly .NET.

Remarque

L’élément ProgramEntryPoint n’est disponible que par le biais du kit SDK Azure version 1.5 ou supérieure.

Le tableau suivant décrit les attributs d’un de l’élément ProgramEntryPoint.

Attribut Type Description
commandLine string Obligatoire. Chemin d’accès, nom de fichier et arguments de ligne de commande du programme à exécuter. Le chemin d’accès est lié au dossier %ROLEROOT%\Approot (ne spécifiez pas %ROLEROOT%\Approot dans la ligne de commande, c’est implicite). %ROLEROOT% est une variable d’environnement gérée par Azure, qui représente l’emplacement du dossier racine de votre rôle. Le dossier %ROLEROOT%\Approot représente le dossier d'application de votre rôle.

Si le programme se termine, le rôle est recyclé. Par conséquent, en règle générale, définissez le programme pour qu’il continue à s’exécuter au lieu qu’il démarre et exécute simplement une tâche déterminée.
setReadyOnProcessStart boolean Obligatoire. Spécifie si l’instance de rôle doit attendre que le programme de ligne de commande signale son démarrage. Cette valeur doit être définie sur true à ce stade. La valeur false est réservée à un usage ultérieur.

Démarrage

L’élément Startup décrit une collection de tâches qui s’exécutent au démarrage du rôle. Cet élément peut être le parent de l’élément Variable. Pour plus d’informations sur l’utilisation des tâches de démarrage de rôle, consultez Guide pratique pour configurer des tâches de démarrage. Cet élément est facultatif et un rôle peut n’avoir qu’un seul bloc startup.

Le tableau suivant décrit l’attribut de l’élément Startup.

Attribut Type Description
priority int À usage interne uniquement.

Tâche

L’élément Task spécifie la tâche de démarrage qui s’exécute au démarrage du rôle. Les tâches de démarrage peuvent être utilisées pour réaliser des tâches en préparation de l’exécution du rôle, telles que l’installation de composants logiciels ou l’exécution d’autres applications. Les tâches s’exécutent dans l’ordre selon lequel elles apparaissent dans le bloc de l’élément Startup.

L’élément Task n’est disponible que par le biais du kit SDK Azure version 1.3 ou supérieure.

Le tableau suivant décrit les attributs d’un de l’élément Task.

Attribut Type Description
commandLine string Obligatoire. Script, comme un fichier CMD, contenant les commandes à exécuter. La commande de démarrage et les fichiers de commandes doivent être enregistrés au format ANSI. Les formats de fichier qui définissent un indicateur d’ordre des octets au début du fichier ne sont pas traités correctement.
executionContext string Spécifie le contexte dans lequel le script est exécuté.

- limited [Par défaut] – Exécution avec les mêmes privilèges que le rôle qui héberge le processus.
- elevated – Exécution avec des privilèges d’administrateur.
taskType string Spécifie le comportement d’exécution de la commande.

- simple [Par défaut] – Le système attend que la tâche se termine avant de lancer d’autres tâches.
- background – Le système n’attend pas que la tâche se termine.
- foreground – Similaire à l’arrière-plan, à la différence que le rôle n’est pas redémarré avant la sortie de toutes les tâches d’avant-plan.

Contenu

L’élément Contents décrit la collection du contenu d’un rôle de travail. Cet élément est le parent de l’élément Content.

L’élément Contents n’est disponible que par le biais du kit SDK Azure version 1.5 ou supérieure.

Contenu

L’élément Content définit l’emplacement source du contenu à copier sur la machine virtuelle Azure, et le chemin de destination dans lequel il est copié.

L’élément Content n’est disponible que par le biais du kit SDK Azure version 1.5 ou supérieure.

Le tableau suivant décrit les attributs d’un de l’élément Content.

Attribut Type Description
destination string Obligatoire. Emplacement sur la machine virtuelle Azure dans lequel le contenu est placé. Cet emplacement est relatif au dossier %ROLEROOT%\Approot.

Cet élément est le parent de l’élément SourceDirectory.

SourceDirectory

L’élément SourceDirectory définit le répertoire local à partir duquel le contenu est copié. Utilisez cet élément pour spécifier le contenu local à copier sur la machine virtuelle Azure.

L’élément SourceDirectory n’est disponible que par le biais du kit SDK Azure version 1.5 ou supérieure.

Le tableau suivant décrit les attributs d’un de l’élément SourceDirectory.

Attribut Type Description
path string Obligatoire. Chemin relatif ou absolu d’un répertoire local dont le contenu est copié sur la machine virtuelle Azure. L’extension des variables d’environnement dans le chemin du répertoire est prise en charge.

Voir aussi

Schéma de définition de services cloud (classique)