WebRole-schema voor definitie van Azure Cloud Services (uitgebreide ondersteuning)

De Azure-webrol is een rol die is aangepast voor het programmeren van webtoepassingen, zoals ASP.NET, PHP, Windows Communication Foundation en FastCGI.

De standaardextensie voor het servicedefinitiebestand is csdef.

Basisschema voor servicedefinities voor een webrol

De basisindeling van een servicedefinitiebestand met een webrol is als volgt.

<ServiceDefinition …>  
  <WebRole name="<web-role-name>" vmsize="<web-role-size>" enableNativeCodeExecution="[true|false]">  
    <Certificates>  
      <Certificate name="<certificate-name>" storeLocation="<certificate-store>" storeName="<store-name>" />  
    </Certificates>      
    <ConfigurationSettings>  
      <Setting name="<setting-name>" />  
    </ConfigurationSettings>  
    <Imports>  
      <Import moduleName="<import-module>"/>  
    </Imports>  
    <Endpoints>  
      <InputEndpoint certificate="<certificate-name>" ignoreRoleInstanceStatus="[true|false]" name="<input-endpoint-name>" protocol="[http|https|tcp|udp]" localPort="<port-number>" port="<port-number>" 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>  
    <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>"/>  
      </EntryPoint>  
    </Runtime>  
    <Sites>  
      <Site name="<web-site-name>">  
        <VirtualApplication name="<application-name>" physicalDirectory="<directory-path>"/>  
        <VirtualDirectory name="<directory-path>" physicalDirectory="<directory-path>"/>  
        <Bindings>  
          <Binding name="<binding-name>" endpointName="<endpoint-name-bound-to>" hostHeader="<url-of-the-site>"/>  
        </Bindings>  
      </Site>  
    </Sites>  
    <Startup priority="<for-internal-use-only>">  
      <Task commandLine="<command-to=execute>" 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>  
  </WebRole>  
</ServiceDefinition>  

Schema-elementen

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

WebRole

ConfigurationSettings

Instelling

LocalResources

LocalStorage

Eindpunten

InternalEndpoint

InstanceInputEndpoint

AllocatePublicPortFrom

FixedPort

FixedPortRange

Getuigschriften

Certificaat

Invoer

Importeren

Runtime

Omgeving

Veranderlijk

RoleInstanceValue

NetFxEntryPoint

Sites

Locatie

VirtualApplication

VirtualApplication

Bindings

Bindend

Start-ups

Taak

Inhoud

Inhoud

SourceDirectory

WebRole

Het WebRole element beschrijft een rol die is aangepast voor het programmeren van webtoepassingen, zoals ondersteund door IIS 7 en ASP.NET. Een service kan nul of meer webrollen bevatten.

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

Kenmerk	Type	Description
naam	tekenreeks	Vereist. De naam voor de webrol. 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 webrol 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 de rol. De standaardwaarde is Small. Zie De grootte van virtuele machines voor Cloud Services voor meer informatie.

ConfigurationSettings

Het ConfigurationSettings element beschrijft de verzameling configuratie-instellingen voor een webrol. 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 webrol. 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 WebRole 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 webrol.

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 webrol poort 80 gebruikt voor HTTP en poort 443 voor HTTPS, kunt u opgeven dat een tweede webrol 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 webrol 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 webrol. Een intern eindpunt is alleen beschikbaar voor andere rolinstanties die binnen de service worden uitgevoerd; het is niet beschikbaar voor clients buiten de service. Webrollen die het Sites element niet bevatten, kunnen slechts één INTERN HTTP-, UDP- of TCP-eindpunt 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 webrol. 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 webrol. 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 webrol.

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 webrol 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 importblok bevatten.

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

Het Environment element beschrijft een verzameling omgevingsvariabele-instellingen voor een webrol. 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 in de opdrachtregel; hierbij 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. Voor HWC-rollen is het pad altijd relatief ten opzichte van de map \%ROLEROOT%\Approot\bin . Als de assembly niet kan worden gevonden ten opzichte van de map \%ROLEROOT%\Approot , wordt de map \%ROLEROOT%\Approot\Approot\bin doorzocht voor volledige IIS- en IIS Express-webrollen. Dit terugvalgedrag voor volledige IIS is geen aanbevolen procedure en is mogelijk verwijderd in toekomstige versies.
targetFrameworkVersion	tekenreeks	Vereist. De versie van het .NET Framework waarop de assembly is gebouwd. Bijvoorbeeld: targetFrameworkVersion="v4.0".

Sites

Het Sites element beschrijft een verzameling websites en webtoepassingen die worden gehost in een webrol. Dit element is het bovenliggende element van het Site element. Als u geen element opgeeft Sites , wordt uw webrol gehost als verouderde webrol en kunt u slechts één website hebben die wordt gehost in uw webrol. Dit element is optioneel en een rol kan slechts één siteblok bevatten.

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

Site

Het Site element geeft een website of webtoepassing op die deel uitmaakt van de webrol.

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

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

Kenmerk	Type	Description
naam	tekenreeks	Vereist. Naam van de website of toepassing.
physicalDirectory	tekenreeks	De locatie van de inhoudsmap voor de hoofdmap van de site. De locatie kan worden opgegeven als een absoluut pad of ten opzichte van de csdef-locatie.

VirtualApplication

Het VirtualApplication element definieert een toepassing in IIS (Internet Information Services) 7 is een groepering van bestanden die inhoud levert of services levert via protocollen, zoals HTTP. Wanneer u een toepassing in IIS 7 maakt, wordt het pad van de toepassing onderdeel van de URL van de site.

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

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

Kenmerk	Type	Description
naam	tekenreeks	Vereist. Hiermee geeft u een naam om de virtuele toepassing te identificeren.
physicalDirectory	tekenreeks	Vereist. Hiermee geeft u het pad op de ontwikkelcomputer die de virtuele toepassing bevat. In de rekenemulator is IIS geconfigureerd voor het ophalen van inhoud van deze locatie. Wanneer deze wordt geïmplementeerd in Azure, wordt de inhoud van de fysieke map samen met de rest van de service verpakt. Wanneer het servicepakket wordt geïmplementeerd in Azure, wordt IIS geconfigureerd met de locatie van de uitgepakte inhoud.

VirtualDirectory

Het VirtualDirectory element geeft een mapnaam (ook wel pad genoemd) op die u in IIS opgeeft en wijst u toe aan een fysieke map op een lokale of externe server.

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

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

Kenmerk	Type	Description
naam	tekenreeks	Vereist. Hiermee geeft u een naam om de virtuele map te identificeren.
waarde	physicalDirectory	Vereist. Hiermee geeft u het pad op de ontwikkelcomputer die de inhoud van de website of virtuele map bevat. In de rekenemulator is IIS geconfigureerd voor het ophalen van inhoud van deze locatie. Wanneer deze wordt geïmplementeerd in Azure, wordt de inhoud van de fysieke map samen met de rest van de service verpakt. Wanneer het servicepakket wordt geïmplementeerd in Azure, wordt IIS geconfigureerd met de locatie van de uitgepakte inhoud.

Bindingen

Het Bindings element beschrijft een verzameling bindingen voor een website. Het is het bovenliggende element van het Binding element. Het element is vereist voor elk Site element. Zie Communicatie inschakelen voor rolinstanties voor meer informatie over het configureren van eindpunten.

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

Binding

Het Binding element geeft configuratiegegevens op die vereist zijn voor aanvragen om te communiceren met een website of webtoepassing.

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

Kenmerk	Type	Description
naam	tekenreeks	Vereist. Hiermee geeft u een naam om de binding te identificeren.
endpointName	tekenreeks	Vereist. Hiermee geeft u de eindpuntnaam op waarmee moet worden verbonden.
hostHeader	tekenreeks	Optioneel. Hiermee geeft u een hostnaam op waarmee u meerdere sites, met verschillende hostnamen, kunt hosten op één combinatie van IP-adres/poortnummer.

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

Volgende stappen

Definitieschema voor cloudservice (uitgebreide ondersteuning).