WebRole-schema voor Azure Cloud Services -definitie (klassiek)

Artikel
06/15/2023

Belangrijk

Cloud Services (klassiek) is nu afgeschaft voor nieuwe klanten en wordt op 31 augustus 2024 voor alle klanten buiten gebruik gesteld. Nieuwe implementaties moeten gebruikmaken van het nieuwe implementatiemodel op basis van Azure Resource Manager Azure Cloud Services (uitgebreide ondersteuning).

De Azure-webrol is een rol die is aangepast voor het programmeren van webtoepassingen, zoals ondersteund door IIS 7, 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 uitgebreid worden beschreven in de volgende secties in dit onderwerp:

WebRole

ConfigurationSettings

InstanceInputEndpoint

AllocatePublicPortFrom

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	Beschrijving
naam	tekenreeks	Vereist. De naam voor de webrol. De naam van de rol moet uniek zijn.
enableNativeCodeExecution	booleaans	Optioneel. De standaardwaarde is `true`; systeemeigen code-uitvoering en volledig vertrouwen zijn standaard ingeschakeld. Stel dit kenmerk in op om de uitvoering van systeemeigen code 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 Grootten 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	Beschrijving
naam	tekenreeks	Vereist. Een unieke naam voor de configuratie-instelling.

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

LocalResources

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

LocalStorage

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

Notitie

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

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

Kenmerk	Type	Beschrijving
naam	tekenreeks	Vereist. Een unieke naam voor het lokale archief.
cleanOnRoleRecycle	booleaans	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 standaard toegewezen opslagruimte 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 Grootten 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 kenmerk name.

Eindpunten

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

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

Notitie

Voor elke geïmplementeerde rol is één exemplaar per rol vereist. De standaardinrichting voor een abonnement is beperkt tot 20 kernen en dus beperkt tot 20 exemplaren van een rol. Als uw toepassing meer exemplaren nodig heeft dan de standaardinrichting biedt, raadpleegt u Ondersteuning voor facturering, abonnementsbeheer en quota 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 voor elke rol in de service zijn opgegeven, moeten uniek zijn. Als u bijvoorbeeld opgeeft dat een webrol gebruikmaakt van poort 80 voor HTTP en poort 443 voor HTTPS, kunt u vervolgens opgeven dat een tweede webrol gebruikmaakt van poort 8080 voor HTTP en poort 8043 voor HTTPS.

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

Kenmerk	Type	Beschrijving
naam	tekenreeks	Vereist. Een unieke naam voor het externe eindpunt.
protocol	tekenreeks	Vereist. Het transportprotocol voor het externe eindpunt. Voor een webrol zijn `HTTP`mogelijke waarden , `HTTPS`, `UDP`of `TCP`.
poort	int	Vereist. De poort voor het externe eindpunt. U kunt elk poortnummer opgeven dat u kiest, maar de poortnummers die voor elke rol in de service zijn opgegeven, moeten uniek zijn. Mogelijke waarden liggen 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. Met `localPort` het kenmerk wordt de externe poort op het eindpunt toegewezen aan een interne poort voor een rol. Dit is handig in scenario's waarin een rol moet communiceren met een intern onderdeel op een andere poort dan de poort die extern beschikbaar wordt gemaakt. Als dit niet wordt opgegeven, is de waarde van `localPort` hetzelfde als het `port` kenmerk. Stel de waarde van `localPort` in op *om automatisch een niet-toegewezen poort toe te wijzen die kan worden gedetecteerd met behulp van de runtime-API. Mogelijke waarden liggen 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	booleaans	Optioneel. Wanneer de waarde van dit kenmerk is ingesteld op `true`, wordt de status van een service genegeerd en wordt het eindpunt niet verwijderd door de load balancer. Deze waarde instellen op `true` nuttig voor het opsporen van fouten in drukke 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 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	Beschrijving
naam	tekenreeks	Vereist. Een unieke naam voor het interne eindpunt.
protocol	tekenreeks	Vereist. Het transportprotocol voor het interne eindpunt. Mogelijke waarden zijn `HTTP`, `TCP`, `UDP`of `ANY`. Een waarde van `ANY` geeft aan dat elk protocol, elke poort is toegestaan.
poort	int	Optioneel. De poort die wordt gebruikt voor verbindingen met interne taakverdeling op het eindpunt. Een eindpunt met gelijke taakverdeling gebruikt twee poorten. De poort die wordt gebruikt voor het openbare IP-adres en de poort die wordt gebruikt voor het privé-IP-adres. Normaal gesproken zijn deze op hetzelfde ingesteld, maar u kunt ervoor kiezen om verschillende poorten te gebruiken. Mogelijke waarden liggen 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 wordt gekoppeld aan een specifiek rolexemplaren met behulp van port forwarding in de load balancer. Elk exemplaarinvoereindpunt wordt toegewezen aan een specifieke poort vanuit een reeks mogelijke poorten. Dit element is het bovenliggende element van het AllocatePublicPortFrom element.

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

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

Kenmerk	Type	Beschrijving
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 wordt doorgestuurd van de load balancer. Mogelijke waarden liggen tussen 1 en 65535, inclusief.
protocol	tekenreeks	Vereist. Het transportprotocol voor het interne eindpunt. Mogelijke waarden zijn `udp` en `tcp`. Gebruiken `tcp` voor http/https-verkeer.

AllocatePublicPortFrom

Het AllocatePublicPortFrom -element beschrijft het openbare poortbereik dat door externe klanten kan worden gebruikt voor toegang tot elk exemplaarinvoereindpunt. Het openbare poortnummer (VIP) wordt toegewezen uit dit bereik en toegewezen aan elk eindpunt van elk afzonderlijk rolexemplementatie 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 azure SDK versie 1.7 of hoger.

FixedPort

Het FixedPort -element geeft de poort voor het interne eindpunt aan, waardoor verbindingen met taakverdeling op het eindpunt mogelijk zijn.

Het FixedPort element is alleen beschikbaar met 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 heeft hetzelfde effect als het instellen van de `FixedPortRange` min en max op dezelfde poort. Mogelijke waarden liggen tussen 1 en 65535, inclusief (Azure SDK versie 1.7 of hoger).

FixedPortRange

Het FixedPortRange -element geeft het poortbereik op dat is toegewezen aan het interne eindpunt of het invoereindpunt van het exemplaar 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 kenmerken min en max 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 kenmerken min en max op elke virtuele machine waarop de rol wordt uitgevoerd.

Het FixedPortRange element is alleen beschikbaar met 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 liggen tussen 1 en 65535, inclusief (Azure SDK versie 1.7 of hoger).
max	tekenreeks	Vereist. De maximale poort in het bereik. Mogelijke waarden liggen 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	Beschrijving
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 zich op de lokale computer bevindt. Mogelijke waarden zijn `CurrentUser` en `LocalMachine`.
storeName	tekenreeks	Vereist. De naam van het certificaatarchief waarin dit certificaat zich op de lokale computer bevindt. Mogelijke waarden zijn de ingebouwde winkelnamen , , , `CA`, `TrustDisallowed`, `TrustedPeople`, , `TrustedPublisher`, `AuthRoot`, , `AddressBook`, , of een aangepaste winkelnaam. `RootMy` Als een aangepaste winkelnaam is opgegeven, wordt de winkel automatisch gemaakt.
permissionLevel	tekenreeks	Optioneel. Hiermee geeft u de toegangsmachtigingen aan de rolprocessen. Als u alleen verhoogde processen toegang wilt geven tot de persoonlijke sleutel, geeft u `elevated` de machtiging op. `limitedOrElevated` met machtiging kunnen alle rolprocessen toegang krijgen tot de persoonlijke sleutel. Mogelijke waarden zijn `limitedOrElevated` en `elevated`. De standaardwaarde is `limitedOrElevated`.

Invoer

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

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

Importeren

Met Import het -element wordt een module opgegeven die moet worden toegevoegd aan het gastbesturingssysteem.

Het Import element is alleen beschikbaar met 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 -Diagnostics Met de modules RemoteAccess en RemoteForwarder kunt u uw rolinstantie configureren voor verbindingen met extern bureaublad. Zie Verbinding met extern bureaublad inschakelen 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 beheren. 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 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 omgevingsvariabeleinstellingen voor een webrol. Dit element is het bovenliggende element van het Variable element. Een rol kan een willekeurig aantal omgevingsvariabelen hebben ingesteld.

Variabele

Met Variable het -element wordt een omgevingsvariabele opgegeven die moet worden ingesteld in het gastbedrijf.

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

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

Kenmerk	Type	Beschrijving
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 het xPath aan 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 te fungeren als het invoerpunt voor de rol.

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

NetFxEntryPoint

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

Notitie

Het NetFxEntryPoint element is alleen beschikbaar met 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 \%ROLEROOT%\Approot niet op in `commandLine`, 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 voor volledige IIS- en IIS Express-webrollen de assembly niet kan worden gevonden ten opzichte van de map \%ROLEROOT%\Approot, wordt de \%ROLEROOT%\Approot\bin doorzocht. Dit terugvalgedrag voor volledige IIS is geen aanbevolen best practice en wordt mogelijk in toekomstige versies verwijderd.
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 Sites element opgeeft, wordt uw webrol gehost als verouderde webrol en kunt u slechts één website in uw webrol hosten. Dit element is optioneel en een rol kan slechts één siteblok hebben.

Het Sites element is alleen beschikbaar met 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 azure SDK versie 1.3 of hoger.

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

Kenmerk	Type	Beschrijving
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 Internet Information Services (IIS) 7 is een groepering van bestanden die inhoud levert of services biedt via protocollen, zoals HTTP. Wanneer u een toepassing maakt in IIS 7, wordt het pad van de toepassing onderdeel van de URL van de site.

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

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

Kenmerk	Type	Beschrijving
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 dat de virtuele toepassing bevat. In de rekenemulator is IIS geconfigureerd om inhoud van deze locatie op te halen. Wanneer u implementeert 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 op (ook wel pad genoemd) die u opgeeft in IIS en die u toe wijst aan een fysieke map op een lokale of externe server.

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

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

Kenmerk	Type	Beschrijving
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 op dat de website of de inhoud van de virtuele map bevat. In de rekenemulator is IIS geconfigureerd om inhoud van deze locatie op te halen. Wanneer u implementeert 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 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 azure SDK versie 1.3 of hoger.

Kenmerk	Type	Beschrijving
naam	tekenreeks	Vereist. Hiermee geeft u een naam om de binding te identificeren.
endpointName	tekenreeks	Vereist. Hiermee geeft u de naam van het eindpunt om aan te binden.
hostHeader	tekenreeks	Optioneel. Hiermee geeft u een hostnaam op waarmee u meerdere sites met verschillende hostnamen kunt hosten op één combinatie van IP-adres en poortnummer.

Opstarten

Het Startup -element beschrijft een verzameling taken die worden uitgevoerd wanneer de rol wordt gestart. Dit element kan het bovenliggende element van het Variable element zijn. Zie Opstarttaken configureren voor meer informatie over het gebruik van de opstarttaken van de rol. 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	Alleen voor intern gebruik.

Taak

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

Het Task element is alleen beschikbaar met 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 die aan het begin van het bestand een bytevolgordemarkering instellen, worden niet correct verwerkt.
executionContext	tekenreeks	Hiermee geeft u de context op waarin het script wordt uitgevoerd. - `limited` [Standaard] : voer uit met dezelfde bevoegdheden als de rol die het proces host. - `elevated` – Uitvoeren met beheerdersbevoegdheden.
taskType	tekenreeks	Hiermee geeft u het uitvoeringsgedrag van de opdracht op. - `simple` [Standaard] : het systeem wacht totdat de taak wordt afgesloten voordat andere taken worden gestart. - `background` – Het systeem wacht niet tot de taak wordt afgesloten. - `foreground` – Vergelijkbaar met achtergrond, behalve dat de rol niet opnieuw wordt gestart totdat alle voorgrondtaken worden 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 azure SDK versie 1.5 of hoger.

Content

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 azure SDK versie 1.5 of hoger.

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

Kenmerk	Type	Description
doel	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 naar de virtuele Azure-machine moet worden gekopieerd.

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

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

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

Zie ook

Definitieschema voor cloudservice (klassiek)

WebRole-schema voor Azure Cloud Services -definitie (klassiek)

Basisschema voor servicedefinities voor een webrol

Schema-elementen

WebRole

ConfigurationSettings

Instelling

LocalResources

LocalStorage

Eindpunten

InputEndpoint

InternalEndpoint

InstanceInputEndpoint

AllocatePublicPortFrom

FixedPort

FixedPortRange

Certificaten

Certificaat

Invoer

Importeren

Runtime

Omgeving

Variabele

RoleInstanceValue

EntryPoint

NetFxEntryPoint

Sites

Site

VirtualApplication

VirtualDirectory

Bindingen

Binding

Opstarten

Taak

Inhoud

Content

SourceDirectory

Zie ook

Aanvullende resources