Definitie workerRole-schema van Azure Cloud Services (uitgebreide ondersteuning)

De Azure-werkrol is een rol die nuttig is voor gegeneraliseerde ontwikkeling en mogelijk achtergrondverwerking voor een webrol uitvoert.

De standaardextensie voor het servicedefinitiebestand is csdef.

Basisschema voor servicedefinities voor een werkrol.

De basisindeling van het servicedefinitiebestand met een werkrol is als volgt.

<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>

Schema-elementen

Het servicedefinitiebestand bevat deze elementen, die in de volgende secties in dit artikel worden beschreven:

WorkerRole

ConfigurationSettings

Instelling

LocalResources

LocalStorage

Eindpunten

InputEndpoint

InternalEndpoint

InstanceInputEndpoint

AllocatePublicPortFrom

FixedPort

FixedPortRange

Getuigschriften

Certificaat

Invoer

Importeren

Runtime

Omgeving

EntryPoint

NetFxEntryPoint

ProgramEntryPoint

Veranderlijk

RoleInstanceValue

Start-ups

Taak

Inhoud

Inhoud

SourceDirectory

WorkerRole

Het WorkerRole element beschrijft een rol die nuttig is voor gegeneraliseerde ontwikkeling en kan achtergrondverwerking uitvoeren voor een webrol. Een service kan nul of meer werkrollen bevatten.

In de volgende tabel worden de kenmerken van het WorkerRole element beschreven.

Kenmerk	Type	Description
naam	tekenreeks	Vereist. De naam voor de werkrol. De naam van de rol moet uniek zijn.
enableNativeCodeExecution	boolean	Optioneel. De standaardwaarde is true: systeemeigen code-uitvoering en volledig vertrouwen zijn standaard ingeschakeld. Stel dit kenmerk in om systeemeigen code-uitvoering voor de werkrol uit te false schakelen en gebruik in plaats daarvan gedeeltelijke vertrouwensrelatie van Azure.
vmsize	tekenreeks	Optioneel. Stel deze waarde in om de grootte te wijzigen van de virtuele machine die is toegewezen aan deze rol. De standaardwaarde is Small. Zie Virtuele-machinegrootten voor Cloud Services voor een lijst met mogelijke grootten van virtuele machines en hun kenmerken.

ConfigurationSettings

Het ConfigurationSettings element beschrijft de verzameling configuratie-instellingen voor een werkrol. Dit element is het bovenliggende element van het Setting element.

Instelling

Het Setting element beschrijft een naam- en waardepaar waarmee een configuratie-instelling voor een exemplaar van een rol wordt opgegeven.

In de volgende tabel worden de kenmerken van het Setting element beschreven.

Kenmerk	Type	Description
naam	tekenreeks	Vereist. Een unieke naam voor de configuratie-instelling.

De configuratie-instellingen voor een rol zijn naam- en waardeparen die zijn gedeclareerd in het servicedefinitiebestand en die zijn ingesteld in het serviceconfiguratiebestand.

LocalResources

Het LocalResources element beschrijft de verzameling lokale opslagbronnen voor een werkrol. Dit element is het bovenliggende element van het LocalStorage element.

LocalStorage

Het LocalStorage element identificeert een lokale opslagresource die bestandssysteemruimte biedt voor de service tijdens runtime. Een rol kan nul of meer lokale opslagresources definiëren.

Notitie

Het LocalStorage element kan worden weergegeven als onderliggend element ter ondersteuning van WorkerRole compatibiliteit met eerdere versies van de Azure SDK.

In de volgende tabel worden de kenmerken van het LocalStorage element beschreven.

Kenmerk	Type	Description
naam	tekenreeks	Vereist. Een unieke naam voor het lokale archief.
cleanOnRoleRecycle	boolean	Optioneel. Geeft aan of het lokale archief moet worden opgeschoond wanneer de rol opnieuw wordt gestart. De standaardwaarde is true.
sizeInMb	int	Optioneel. De gewenste hoeveelheid opslagruimte die moet worden toegewezen voor het lokale archief, in MB. Als dit niet is opgegeven, is de standaardopslagruimte 100 MB. De minimale hoeveelheid opslagruimte die kan worden toegewezen, is 1 MB. De maximale grootte van de lokale resources is afhankelijk van de grootte van de virtuele machine. Zie De grootte van virtuele machines voor Cloud Services voor meer informatie.

De naam van de map die is toegewezen aan de lokale opslagresource komt overeen met de waarde die is opgegeven voor het naamkenmerk.

Eindpunten

Het Endpoints element beschrijft de verzameling invoereindpunten (extern), intern en exemplaarinvoereindpunten voor een rol. Dit element is het bovenliggende element van de InputEndpoint, InternalEndpointen InstanceInputEndpoint elementen.

Invoer- en interne eindpunten worden afzonderlijk toegewezen. Een service kan in totaal 25 invoer-, interne en instantie-invoereindpunten hebben, die kunnen worden toegewezen aan de 25 rollen die zijn toegestaan in een service. Als u bijvoorbeeld vijf rollen hebt, kunt u vijf invoereindpunten per rol toewijzen of kunt u 25 invoereindpunten toewijzen aan één rol of één invoereindpunt toewijzen aan elk 25 rollen.

Notitie

Elke geïmplementeerde rol vereist één exemplaar per rol. De standaardinrichting voor een abonnement is beperkt tot 20 kernen en is dus beperkt tot 20 exemplaren van een rol. Als voor uw toepassing meer exemplaren zijn vereist dan standaard wordt ingericht, raadpleegt u Facturering, Abonnementsbeheer en Quota-ondersteuning voor meer informatie over het verhogen van uw quotum.

InputEndpoint

Het InputEndpoint element beschrijft een extern eindpunt voor een werkrol.

U kunt meerdere eindpunten definiëren die een combinatie zijn van HTTP-, HTTPS-, UDP- en TCP-eindpunten. U kunt elk poortnummer opgeven dat u kiest voor een invoereindpunt, maar de poortnummers die zijn opgegeven voor elke rol in de service, moeten uniek zijn. Als u bijvoorbeeld opgeeft dat een rol poort 80 gebruikt voor HTTP en poort 443 voor HTTPS, kunt u opgeven dat een tweede rol poort 8080 gebruikt voor HTTP en poort 8043 voor HTTPS.

In de volgende tabel worden de kenmerken van het InputEndpoint element beschreven.

Kenmerk	Type	Description
naam	tekenreeks	Vereist. Een unieke naam voor het externe eindpunt.
protocol	tekenreeks	Vereist. Het transportprotocol voor het externe eindpunt. Voor een werkrol zijn HTTPmogelijke waarden , of HTTPSUDPTCP.
poort	int	Vereist. De poort voor het externe eindpunt. U kunt elk poortnummer opgeven dat u kiest, maar de poortnummers die zijn opgegeven voor elke rol in de service, moeten uniek zijn. Mogelijke waarden variëren tussen 1 en 65535, inclusief (Azure SDK versie 1.7 of hoger).
certificaat	tekenreeks	Vereist voor een HTTPS-eindpunt. De naam van een certificaat dat is gedefinieerd door een Certificate element.
localPort	int	Optioneel. Hiermee geeft u een poort op die wordt gebruikt voor interne verbindingen op het eindpunt. Het localPort kenmerk wijst de externe poort op het eindpunt toe aan een interne poort voor een rol. Dit kenmerk is handig in scenario's waarin een rol moet communiceren met een intern onderdeel op een poort die verschilt van het kenmerk dat extern wordt weergegeven. Als dit niet is opgegeven, is de waarde localPort gelijk aan het port kenmerk. Stel de waarde van localPort '*' in om automatisch een niet-toegewezen poort toe te wijzen die kan worden gedetecteerd met behulp van de runtime-API. Mogelijke waarden variëren tussen 1 en 65535, inclusief (Azure SDK versie 1.7 of hoger). Het localPort kenmerk is alleen beschikbaar met azure SDK versie 1.3 of hoger.
ignoreRoleInstanceStatus	boolean	Optioneel. Wanneer de waarde van dit kenmerk is ingesteld trueop, wordt de status van een service genegeerd en wordt het eindpunt niet verwijderd door de load balancer. Deze waarde instellen op true handig voor het opsporen van fouten in bezet exemplaren van een service. De standaardwaarde is false. Opmerking: Een eindpunt kan nog steeds verkeer ontvangen, zelfs als de rol niet de status Gereed heeft.
loadBalancerProbe	tekenreeks	Optioneel. De naam van de load balancer-test die is gekoppeld aan het invoereindpunt. Zie Het LoadBalancerProbe-schema voor meer informatie.

InternalEndpoint

Het InternalEndpoint element beschrijft een intern eindpunt voor een werkrol. Een intern eindpunt is alleen beschikbaar voor andere rolinstanties die binnen de service worden uitgevoerd; het is niet beschikbaar voor clients buiten de service. Een werkrol kan maximaal vijf interne HTTP-, UDP- of TCP-eindpunten hebben.

In de volgende tabel worden de kenmerken van het InternalEndpoint element beschreven.

Kenmerk	Type	Description
naam	tekenreeks	Vereist. Een unieke naam voor het interne eindpunt.
protocol	tekenreeks	Vereist. Het transportprotocol voor het interne eindpunt. Mogelijke waarden zijnHTTP, TCP, of UDPANY. Een waarde waarmee ANY wordt aangegeven dat elk protocol, elke poort is toegestaan.
poort	int	Optioneel. De poort die wordt gebruikt voor interne verbindingen met gelijke taakverdeling op het eindpunt. Een eindpunt met gelijke taakverdeling maakt gebruik van twee poorten. De poort die wordt gebruikt voor het openbare IP-adres en de poort die wordt gebruikt op het privé-IP-adres. Deze waarden zijn doorgaans ingesteld op hetzelfde, maar u kunt ervoor kiezen om verschillende poorten te gebruiken. Mogelijke waarden variëren tussen 1 en 65535, inclusief (Azure SDK versie 1.7 of hoger). Het Port kenmerk is alleen beschikbaar met azure SDK versie 1.3 of hoger.

InstanceInputEndpoint

Het InstanceInputEndpoint element beschrijft een exemplaarinvoereindpunt voor een werkrol. Een exemplaarinvoereindpunt is gekoppeld aan een specifiek rolexemplaar met behulp van port forwarding in de load balancer. Elk exemplaarinvoereindpunt wordt toegewezen aan een specifieke poort vanuit een bereik van mogelijke poorten. Dit element is het bovenliggende element van het AllocatePublicPortFrom element.

Het InstanceInputEndpoint element is alleen beschikbaar met de Azure SDK versie 1.7 of hoger.

In de volgende tabel worden de kenmerken van het InstanceInputEndpoint element beschreven.

Kenmerk	Type	Description
naam	tekenreeks	Vereist. Een unieke naam voor het eindpunt.
localPort	int	Vereist. Hiermee geeft u de interne poort op waarnaar alle rolinstanties luisteren om binnenkomend verkeer te ontvangen dat is doorgestuurd vanuit de load balancer. Mogelijke waarden variëren tussen 1 en 65535, inclusief.
protocol	tekenreeks	Vereist. Het transportprotocol voor het interne eindpunt. Mogelijke waarden zijn udp en tcp. Gebruik tcp dit voor http/https-verkeer.

AllocatePublicPortFrom

In AllocatePublicPortFrom het element wordt het bereik van de openbare poort beschreven dat externe klanten kunnen gebruiken voor toegang tot elk exemplaarinvoereindpunt. Het openbare poortnummer (VIP) wordt toegewezen vanuit dit bereik en toegewezen aan elk eindpunt van het afzonderlijke rolexemplaren tijdens de implementatie en update van de tenant. Dit element is het bovenliggende element van het FixedPortRange element.

Het AllocatePublicPortFrom element is alleen beschikbaar met de Azure SDK versie 1.7 of hoger.

FixedPort

Het FixedPort element geeft de poort op voor het interne eindpunt, waarmee verbindingen met gelijke taakverdeling op het eindpunt mogelijk zijn.

Het FixedPort element is alleen beschikbaar met de Azure SDK versie 1.3 of hoger.

In de volgende tabel worden de kenmerken van het FixedPort element beschreven.

Kenmerk	Type	Description
poort	int	Vereist. De poort voor het interne eindpunt. Dit kenmerk heeft hetzelfde effect als het instellen van de FixedPortRange min en max op dezelfde poort. Mogelijke waarden variëren tussen 1 en 65535, inclusief (Azure SDK versie 1.7 of hoger).

FixedPortRange

Het FixedPortRange element geeft het bereik aan van poorten die zijn toegewezen aan het interne eindpunt of het eindpunt van de instantie-invoer en stelt de poort in die wordt gebruikt voor verbindingen met gelijke taakverdeling op het eindpunt.

Notitie

Het FixedPortRange element werkt anders, afhankelijk van het element waarin het zich bevindt. Wanneer het FixedPortRange element zich in het InternalEndpoint element bevindt, worden alle poorten op de load balancer geopend binnen het bereik van de minimum- en maximumkenmerken voor alle virtuele machines waarop de rol wordt uitgevoerd. Wanneer het FixedPortRange element zich in het InstanceInputEndpoint element bevindt, wordt er slechts één poort geopend binnen het bereik van de minimale en maximale kenmerken op elke virtuele machine waarop de rol wordt uitgevoerd.

Het FixedPortRange element is alleen beschikbaar met de Azure SDK versie 1.3 of hoger.

In de volgende tabel worden de kenmerken van het FixedPortRange element beschreven.

Kenmerk	Type	Description
min.	int	Vereist. De minimale poort in het bereik. Mogelijke waarden variëren tussen 1 en 65535, inclusief (Azure SDK versie 1.7 of hoger).
max	tekenreeks	Vereist. De maximale poort in het bereik. Mogelijke waarden variëren tussen 1 en 65535, inclusief (Azure SDK versie 1.7 of hoger).

Certificaten

Het Certificates element beschrijft de verzameling certificaten voor een werkrol. Dit element is het bovenliggende element van het Certificate element. Een rol kan een willekeurig aantal gekoppelde certificaten hebben. Zie Het servicedefinitiebestand wijzigen met een certificaat voor meer informatie over het gebruik van het certificaatelement.

Certificaat

Het Certificate element beschrijft een certificaat dat is gekoppeld aan een werkrol.

In de volgende tabel worden de kenmerken van het Certificate element beschreven.

Kenmerk	Type	Description
naam	tekenreeks	Vereist. Een naam voor dit certificaat, dat wordt gebruikt om ernaar te verwijzen wanneer het is gekoppeld aan een HTTPS-element InputEndpoint .
storeLocation	tekenreeks	Vereist. De locatie van het certificaatarchief waar dit certificaat kan worden gevonden op de lokale computer. Mogelijke waarden zijn CurrentUser en LocalMachine.
storeName	tekenreeks	Vereist. De naam van het certificaatarchief waar dit certificaat zich op de lokale computer bevindt. Mogelijke waarden zijn de ingebouwde winkelnamen My, , Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, , AddressBookof een aangepaste winkelnaam. Als er een aangepaste winkelnaam is opgegeven, wordt de store automatisch gemaakt.
permissionLevel	tekenreeks	Optioneel. Hiermee geeft u de toegangsmachtigingen op die zijn verleend aan de rolprocessen. Als u wilt dat alleen verhoogde processen toegang hebben tot de persoonlijke sleutel, geeft u elevated de machtiging op. limitedOrElevated met de machtiging kunnen alle rolprocessen toegang krijgen tot de persoonlijke sleutel. Mogelijke waarden zijn limitedOrElevated en elevated. De standaardwaarde is limitedOrElevated.

Imports

Het Imports element beschrijft een verzameling importmodules voor een werkrol die onderdelen toevoegt aan het gastbesturingssysteem. Dit element is het bovenliggende element van het Import element. Dit element is optioneel en een rol kan slechts één runtimeblok hebben.

Het Imports element is alleen beschikbaar met de Azure SDK versie 1.3 of hoger.

Importeren

Het Import element geeft een module op die moet worden toegevoegd aan het gastbesturingssysteem.

Het Import element is alleen beschikbaar met de Azure SDK versie 1.3 of hoger.

In de volgende tabel worden de kenmerken van het Import element beschreven.

Kenmerk	Type	Description
moduleName	tekenreeks	Vereist. De naam van de module die moet worden geïmporteerd. Geldige importmodules zijn: - RemoteAccess - RemoteForwarder -Diagnostiek Met de modules RemoteAccess en RemoteForwarder kunt u uw rolexemplaren configureren voor verbindingen met extern bureaublad. Zie Extensies voor meer informatie. Met de module Diagnostische gegevens kunt u diagnostische gegevens verzamelen voor een rolinstantie

Runtime

Het Runtime element beschrijft een verzameling omgevingsvariabele-instellingen voor een werkrol die de runtime-omgeving van het Azure-hostproces bepaalt. Dit element is het bovenliggende element van het Environment element. Dit element is optioneel en een rol kan slechts één runtimeblok hebben.

Het Runtime element is alleen beschikbaar met de Azure SDK versie 1.3 of hoger.

In de volgende tabel worden de kenmerken van het Runtime element beschreven:

Kenmerk	Type	Description
executionContext	tekenreeks	Optioneel. Hiermee geeft u de context op waarin het rolproces wordt gestart. De standaardcontext is limited. - limited – Het proces wordt gestart zonder beheerdersbevoegdheden. - elevated – Het proces wordt gestart met beheerdersbevoegdheden.

Omgeving

In Environment het element wordt een verzameling omgevingsvariabeleinstellingen voor een werkrol beschreven. Dit element is het bovenliggende element van het Variable element. Een rol kan een willekeurig aantal omgevingsvariabelen hebben ingesteld.

Variabel

Het Variable element geeft een omgevingsvariabele op die moet worden ingesteld in de gastbesturingssysteem.

Het Variable element is alleen beschikbaar met de Azure SDK versie 1.3 of hoger.

In de volgende tabel worden de kenmerken van het Variable element beschreven:

Kenmerk	Type	Description
naam	tekenreeks	Vereist. De naam van de omgevingsvariabele die moet worden ingesteld.
waarde	tekenreeks	Optioneel. De waarde die moet worden ingesteld voor de omgevingsvariabele. U moet een waardekenmerk of een RoleInstanceValue element opnemen.

RoleInstanceValue

Het RoleInstanceValue element geeft de xPath op waaruit de waarde van de variabele moet worden opgehaald.

In de volgende tabel worden de kenmerken van het RoleInstanceValue element beschreven.

Kenmerk	Type	Description
xpath	tekenreeks	Optioneel. Locatiepad van implementatie-instellingen voor het exemplaar. Zie Configuratievariabelen met XPath voor meer informatie. U moet een waardekenmerk of een RoleInstanceValue element opnemen.

EntryPoint

Het EntryPoint element geeft het toegangspunt voor een rol op. Dit element is het bovenliggende element van de NetFxEntryPoint elementen. Met deze elementen kunt u een andere toepassing dan de standaard-WaWorkerHost.exe opgeven om als het rolinvoerpunt te fungeren.

Het EntryPoint element is alleen beschikbaar met de Azure SDK versie 1.5 of hoger.

NetFxEntryPoint

Het NetFxEntryPoint element geeft het programma op dat moet worden uitgevoerd voor een rol.

Notitie

Het NetFxEntryPoint element is alleen beschikbaar met de Azure SDK versie 1.5 of hoger.

In de volgende tabel worden de kenmerken van het NetFxEntryPoint element beschreven.

Kenmerk	Type	Description
assemblyName	tekenreeks	Vereist. Het pad en de bestandsnaam van de assembly die het toegangspunt bevat. Het pad is relatief ten opzichte van de map \%ROLEROOT%\Approot (geef geen \%ROLEROOT%\Approot op de opdrachtregel op; deze wordt ervan uitgegaan). %ROLEROOT% is een omgevingsvariabele die wordt onderhouden door Azure en vertegenwoordigt de locatie van de hoofdmap voor uw rol. De map \%ROLEROOT%\Approot vertegenwoordigt de toepassingsmap voor uw rol.
targetFrameworkVersion	tekenreeks	Vereist. De versie van het .NET Framework waarop de assembly is gebouwd. Bijvoorbeeld: targetFrameworkVersion="v4.0".

ProgramEntryPoint

Het ProgramEntryPoint element geeft het programma op dat moet worden uitgevoerd voor een rol. Met ProgramEntryPoint het element kunt u een programmainvoerpunt opgeven dat niet is gebaseerd op een .NET-assembly.

Notitie

Het ProgramEntryPoint element is alleen beschikbaar met de Azure SDK versie 1.5 of hoger.

In de volgende tabel worden de kenmerken van het ProgramEntryPoint element beschreven.

Kenmerk	Type	Description
commandLine	tekenreeks	Vereist. Het pad, de bestandsnaam en eventuele opdrachtregelargumenten van het programma dat moet worden uitgevoerd. Het pad is relatief ten opzichte van de map %ROLEROOT%\Approot (geef %ROLEROOT%\Approot niet op in de opdrachtregel; wordt ervan uitgegaan). %ROLEROOT% is een omgevingsvariabele die wordt onderhouden door Azure en vertegenwoordigt de locatie van de hoofdmap voor uw rol. De map %ROLEROOT%\Approot vertegenwoordigt de toepassingsmap voor uw rol. Als het programma eindigt, wordt de rol gerecycled, dus stel het programma in het algemeen in om door te gaan, in plaats van een programma te zijn dat net wordt gestart en een eindige taak uitvoert.
setReadyOnProcessStart	boolean	Vereist. Hiermee geeft u op of het rolexemplaren wachten totdat het opdrachtregelprogramma wordt aangegeven wanneer het wordt gestart. Deze waarde moet op dit moment worden ingesteld true . Het instellen van de waarde false is gereserveerd voor toekomstig gebruik.

Opstarten

Het Startup element beschrijft een verzameling taken die worden uitgevoerd wanneer de rol wordt gestart. Dit element kan het bovenliggende element zijn Variable . Zie Opstarttaken voor rollen configureren voor meer informatie over het gebruik van de opstarttaken voor rollen. Dit element is optioneel en een rol kan slechts één opstartblok hebben.

In de volgende tabel wordt het kenmerk van het Startup element beschreven.

Kenmerk	Type	Description
priority	int	Uitsluitend voor intern gebruik.

Opdracht

Het Task element specificeert de opstarttaak die plaatsvindt wanneer de rol wordt gestart. Opstarttaken kunnen worden gebruikt om taken uit te voeren die de rol voorbereiden om dergelijke installatiesoftwareonderdelen uit te voeren of andere toepassingen uit te voeren. Taken worden uitgevoerd in de volgorde waarin ze worden weergegeven in het Startup elementblok.

Het Task element is alleen beschikbaar met de Azure SDK versie 1.3 of hoger.

In de volgende tabel worden de kenmerken van het Task element beschreven.

Kenmerk	Type	Description
commandLine	tekenreeks	Vereist. Een script, zoals een CMD-bestand, met de opdrachten die moeten worden uitgevoerd. Opstartopdracht en batchbestanden moeten worden opgeslagen in ANSI-indeling. Bestandsindelingen waarmee een bytevolgordemarkering aan het begin van de bestandsprocessen onjuist is ingesteld.
executionContext	tekenreeks	Hiermee geeft u de context op waarin het script wordt uitgevoerd. - limited [Standaard] - Uitvoeren met dezelfde bevoegdheden als de rol die als host fungeert voor het proces. - elevated – Uitvoeren met beheerdersbevoegdheden.
taskType	tekenreeks	Hiermee geeft u het uitvoeringsgedrag van de opdracht. - simple [Standaard]: het systeem wacht totdat de taak wordt afgesloten voordat andere taken worden gestart. - background – Het systeem wacht niet totdat de taak is afgesloten. - foreground – Vergelijkbaar met de achtergrond, behalve dat de rol pas opnieuw wordt gestart nadat alle voorgrondtaken zijn afgesloten.

Inhoud

Het Contents element beschrijft de verzameling inhoud voor een werkrol. Dit element is het bovenliggende element van het Content element.

Het Contents element is alleen beschikbaar met de Azure SDK versie 1.5 of hoger.

Inhoud

Het Content element definieert de bronlocatie van inhoud die moet worden gekopieerd naar de virtuele Azure-machine en het doelpad waarnaar deze wordt gekopieerd.

Het Content element is alleen beschikbaar met de Azure SDK versie 1.5 of hoger.

In de volgende tabel worden de kenmerken van het Content element beschreven.

Kenmerk	Type	Description
destination	tekenreeks	Vereist. Locatie op de virtuele Azure-machine waarop de inhoud wordt geplaatst. Deze locatie is relatief ten opzichte van de map %ROLEROOT%\Approot.

Dit element is het bovenliggende element van het SourceDirectory element.

SourceDirectory

Het SourceDirectory element definieert de lokale map waaruit inhoud wordt gekopieerd. Gebruik dit element om de lokale inhoud op te geven die u naar de virtuele Azure-machine wilt kopiëren.

Het SourceDirectory element is alleen beschikbaar met de Azure SDK versie 1.5 of hoger.

In de volgende tabel worden de kenmerken van het SourceDirectory element beschreven.

Kenmerk	Type	Description
path	tekenreeks	Vereist. Relatief of absoluut pad van een lokale map waarvan de inhoud naar de virtuele Azure-machine wordt gekopieerd. Uitbreiding van omgevingsvariabelen in het mappad wordt ondersteund.

Zie ook

Definitieschema voor cloudservice (uitgebreide ondersteuning).