WebRole-schema för Azure Cloud Services (klassisk) definition

Artikel
06/15/2023

Viktigt

Cloud Services (klassisk) är nu inaktuell för nya kunder och kommer att dras tillbaka den 31 augusti 2024 för alla kunder. Nya distributioner bör använda den nya Azure Resource Manager-baserade distributionsmodellen Azure Cloud Services (utökad support).

Azure-webbrollen är en roll som är anpassad för webbprogramprogrammering som stöds av IIS 7, till exempel ASP.NET, PHP, Windows Communication Foundation och FastCGI.

Standardtillägget för tjänstdefinitionsfilen är .csdef.

Grundläggande tjänstdefinitionsschema för en webbroll

Det grundläggande formatet för en tjänstdefinitionsfil som innehåller en webbroll är följande.

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

Schemaelement

Tjänstdefinitionsfilen innehåller dessa element, som beskrivs i detalj i efterföljande avsnitt i det här avsnittet:

WebRole

ConfigurationSettings

InstanceInputEndpoint

AllokeraPublicPortFrom

WebRole

Elementet WebRole beskriver en roll som är anpassad för webbprogramprogrammering, vilket stöds av IIS 7 och ASP.NET. En tjänst kan innehålla noll eller flera webbroller.

I följande tabell beskrivs elementets WebRole attribut.

Attribut	Typ	Beskrivning
name	sträng	Krävs. Namnet på webbrollen. Rollens namn måste vara unikt.
enableNativeCodeExecution	boolean	Valfritt. Standardvärdet är `true`; intern kodkörning och fullständigt förtroende är aktiverat som standard. Ange det här attributet till `false` för att inaktivera intern kodkörning för webbrollen och använd partiellt förtroende i Azure i stället.
vmsize	sträng	Valfritt. Ange det här värdet om du vill ändra storleken på den virtuella dator som tilldelas rollen. Standardvärdet är `Small`. Mer information finns i Storlekar på virtuella datorer för Cloud Services.

ConfigurationSettings

Elementet ConfigurationSettings beskriver samlingen med konfigurationsinställningar för en webbroll. Det här elementet är överordnat för elementet Setting .

Inställning

Elementet Setting beskriver ett namn- och värdepar som anger en konfigurationsinställning för en instans av en roll.

I följande tabell beskrivs elementets Setting attribut.

Attribut	Typ	Beskrivning
name	sträng	Krävs. Ett unikt namn för konfigurationsinställningen.

Konfigurationsinställningarna för en roll är namn- och värdepar som deklareras i tjänstdefinitionsfilen och anges i tjänstkonfigurationsfilen.

LocalResources

Elementet LocalResources beskriver samlingen av lokala lagringsresurser för en webbroll. Det här elementet är överordnat för elementet LocalStorage .

Localstorage

Elementet LocalStorage identifierar en lokal lagringsresurs som tillhandahåller filsystemutrymme för tjänsten vid körning. En roll kan definiera noll eller flera lokala lagringsresurser.

Anteckning

Elementet LocalStorage kan visas som underordnat elementet WebRole för att stödja kompatibilitet med tidigare versioner av Azure SDK.

I följande tabell beskrivs elementets LocalStorage attribut.

Attribut	Typ	Beskrivning
name	sträng	Krävs. Ett unikt namn för det lokala arkivet.
cleanOnRoleRecycle	boolean	Valfritt. Anger om det lokala arkivet ska rensas när rollen startas om. Standardvärdet är `true`.
sizeInMb	int	Valfritt. Önskad mängd lagringsutrymme som ska allokeras för det lokala arkivet i MB. Om inget anges är det allokerade standardutrymmet 100 MB. Den minsta mängden lagringsutrymme som kan allokeras är 1 MB. Den maximala storleken på de lokala resurserna beror på storleken på den virtuella datorn. Mer information finns i Storlekar på virtuella datorer för Cloud Services.

Namnet på den katalog som allokerats till den lokala lagringsresursen motsvarar det värde som anges för namnattributet.

Slutpunkter

Elementet Endpoints beskriver samlingen med indata (externa), interna och instansindataslutpunkter för en roll. Det här elementet är överordnat för elementen InputEndpoint, InternalEndpointoch InstanceInputEndpoint .

Indata och interna slutpunkter allokeras separat. En tjänst kan ha totalt 25 indata-, interna och instansindataslutpunkter som kan allokeras mellan de 25 roller som tillåts i en tjänst. Om du till exempel har 5 roller kan du allokera 5 indataslutpunkter per roll eller så kan du allokera 25 indataslutpunkter till en enda roll, eller så kan du allokera 1 indataslutpunkt vardera till 25 roller.

Anteckning

Varje roll som distribueras kräver en instans per roll. Standardetablering för en prenumeration är begränsad till 20 kärnor och är därför begränsad till 20 instanser av en roll. Om ditt program kräver fler instanser än vad som tillhandahålls av standardetablering kan du läsa Mer information om hur du ökar din kvot finns i Fakturering, Prenumerationshantering och Kvotsupport .

InputEndpoint

Elementet InputEndpoint beskriver en extern slutpunkt för en webbroll.

Du kan definiera flera slutpunkter som är en kombination av HTTP-, HTTPS-, UDP- och TCP-slutpunkter. Du kan ange valfritt portnummer som du väljer för en indataslutpunkt, men portnumren som anges för varje roll i tjänsten måste vara unika. Om du till exempel anger att en webbroll använder port 80 för HTTP och port 443 för HTTPS kan du ange att en andra webbroll använder port 8080 för HTTP och port 8043 för HTTPS.

I följande tabell beskrivs elementets InputEndpoint attribut.

Attribut	Typ	Beskrivning
name	sträng	Krävs. Ett unikt namn för den externa slutpunkten.
Protokollet	sträng	Krävs. Transportprotokollet för den externa slutpunkten. För en webbroll är `HTTP`möjliga värden , `HTTPS`, `UDP`eller `TCP`.
port	int	Krävs. Porten för den externa slutpunkten. Du kan ange valfritt portnummer som du väljer, men portnumren som anges för varje roll i tjänsten måste vara unika. Möjliga värden mellan 1 och 65535 , inklusive (Azure SDK version 1.7 eller senare).
certifikat	sträng	Krävs för en HTTPS-slutpunkt. Namnet på ett certifikat som definieras av ett `Certificate` -element.
localPort	int	Valfritt. Anger en port som används för interna anslutningar på slutpunkten. Attributet `localPort` mappar den externa porten på slutpunkten till en intern port för en roll. Detta är användbart i scenarier där en roll måste kommunicera med en intern komponent på en port som skiljer sig från den som exponeras externt. Om det inte anges är värdet `localPort` för samma som attributet `port` . Ange värdet för till "*" för att automatiskt tilldela en oallokerad port som kan identifieras med hjälp av `localPort` körnings-API:et. Möjliga värden mellan 1 och 65535 , inklusive (Azure SDK version 1.7 eller senare). Attributet `localPort` är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.
ignoreRoleInstanceStatus	boolean	Valfritt. När värdet för det här attributet är inställt på `true`ignoreras statusen för en tjänst och slutpunkten tas inte bort av lastbalanseraren. Ange det här värdet till `true` användbart för felsökning av upptagna instanser av en tjänst. Standardvärdet är `false`. Observera: En slutpunkt kan fortfarande ta emot trafik även om rollen inte är i tillståndet Klar.
loadBalancerProbe	sträng	Valfritt. Namnet på lastbalanserarens avsökning som är associerad med indataslutpunkten. Mer information finns i LoadBalancerProbe Schema.

InternalEndpoint

Elementet InternalEndpoint beskriver en intern slutpunkt för en webbroll. En intern slutpunkt är endast tillgänglig för andra rollinstanser som körs i tjänsten. Det är inte tillgängligt för klienter utanför tjänsten. Webbroller som inte innehåller elementet Sites kan bara ha en enda intern HTTP-, UDP- eller TCP-slutpunkt.

I följande tabell beskrivs elementets InternalEndpoint attribut.

Attribut	Typ	Beskrivning
name	sträng	Krävs. Ett unikt namn för den interna slutpunkten.
Protokollet	sträng	Krävs. Transportprotokollet för den interna slutpunkten. Möjliga värden är `HTTP`, `TCP`, `UDP`eller `ANY`. Värdet `ANY` anger att alla protokoll, alla portar tillåts.
port	int	Valfritt. Porten som används för interna belastningsutjämningsanslutningar på slutpunkten. En belastningsutjämningsslutpunkt använder två portar. Porten som används för den offentliga IP-adressen och den port som används på den privata IP-adressen. Dessa är vanligtvis inställda på samma, men du kan välja att använda olika portar. Möjliga värden mellan 1 och 65535 , inklusive (Azure SDK version 1.7 eller senare). Attributet `Port` är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

InstanceInputEndpoint

Elementet InstanceInputEndpoint beskriver en instansslutpunkt för indata till en webbroll. En instansindataslutpunkt är associerad med en specifik rollinstans med hjälp av portvidarebefordring i lastbalanseraren. Varje instansindataslutpunkt mappas till en specifik port från ett antal möjliga portar. Det här elementet är överordnat för elementet AllocatePublicPortFrom .

Elementet InstanceInputEndpoint är endast tillgängligt med Azure SDK version 1.7 eller senare.

I följande tabell beskrivs elementets InstanceInputEndpoint attribut.

Attribut	Typ	Beskrivning
name	sträng	Krävs. Ett unikt namn för slutpunkten.
localPort	int	Krävs. Anger den interna port som alla rollinstanser lyssnar på för att ta emot inkommande trafik som vidarebefordras från lastbalanseraren. Möjliga värden sträcker sig mellan 1 och 65535, inklusive.
Protokollet	sträng	Krävs. Transportprotokollet för den interna slutpunkten. Möjliga värden är `udp` eller `tcp`. Används `tcp` för http/https-baserad trafik.

AllokeraPublicPortFrom

Elementet AllocatePublicPortFrom beskriver det offentliga portintervall som kan användas av externa kunder för att komma åt varje instansindataslutpunkt. Det offentliga portnumret (VIP) allokeras från det här intervallet och tilldelas till varje enskild rollinstansslutpunkt under klientdistribution och uppdatering. Det här elementet är överordnat för elementet FixedPortRange .

Elementet AllocatePublicPortFrom är endast tillgängligt med Azure SDK version 1.7 eller senare.

FixedPort

Elementet FixedPort anger porten för den interna slutpunkten, som aktiverar belastningsutjämningsanslutningar på slutpunkten.

- FixedPort elementet är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

I följande tabell beskrivs elementets FixedPort attribut.

Attribut	Typ	Beskrivning
port	int	Krävs. Porten för den interna slutpunkten. Detta har samma effekt som att ställa in `FixedPortRange` min och max på samma port. Möjliga värden sträcker sig mellan 1 och 65535, inklusive (Azure SDK version 1.7 eller senare).

FixedPortRange

Elementet FixedPortRange anger det portintervall som tilldelas till den interna slutpunkten eller instansens indataslutpunkt och anger den port som används för belastningsutjämningsanslutningar på slutpunkten.

Anteckning

Elementet FixedPortRange fungerar annorlunda beroende på vilket element det finns i. När elementet FixedPortRange finns i -elementet InternalEndpoint öppnas alla portar i lastbalanseraren inom intervallet för attributen min och max för alla virtuella datorer där rollen körs. När elementet FixedPortRange finns i -elementet InstanceInputEndpoint öppnas bara en port inom intervallet för attributen min och max på varje virtuell dator som kör rollen.

- FixedPortRange elementet är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

I följande tabell beskrivs elementets FixedPortRange attribut.

Attribut	Typ	Beskrivning
min	int	Krävs. Minsta port i intervallet. Möjliga värden sträcker sig mellan 1 och 65535, inklusive (Azure SDK version 1.7 eller senare).
max	sträng	Krävs. Den maximala porten i intervallet. Möjliga värden sträcker sig mellan 1 och 65535, inklusive (Azure SDK version 1.7 eller senare).

Certifikat

Elementet Certificates beskriver samlingen av certifikat för en webbroll. Det här elementet är överordnat för elementet Certificate . En roll kan ha valfritt antal associerade certifikat. Mer information om hur du använder certifikatelementet finns i Ändra tjänstdefinitionsfilen med ett certifikat.

Certifikat

Elementet Certificate beskriver ett certifikat som är associerat med en webbroll.

I följande tabell beskrivs elementets Certificate attribut.

Attribut	Typ	Beskrivning
name	sträng	Krävs. Ett namn på det här certifikatet, som används för att referera till det när det är associerat med ett HTTPS-element `InputEndpoint` .
storeLocation	sträng	Krävs. Platsen för certifikatarkivet där det här certifikatet kan hittas på den lokala datorn. Möjliga värden är `CurrentUser` och `LocalMachine`.
storeName	sträng	Krävs. Namnet på certifikatarkivet där det här certifikatet finns på den lokala datorn. Möjliga värden är de inbyggda butiksnamnen `My`, `Root`, `CA`, `Trust`, `Disallowed`, `TrustedPeople`, `TrustedPublisher`, `AuthRoot`, `AddressBook`eller ett anpassat butiksnamn. Om ett anpassat butiksnamn anges skapas arkivet automatiskt.
permissionLevel	sträng	Valfritt. Anger de åtkomstbehörigheter som ges till rollprocesserna. Om du bara vill att förhöjda processer ska kunna komma åt den privata nyckeln anger du `elevated` behörighet. `limitedOrElevated` behörighet tillåter alla rollprocesser att komma åt den privata nyckeln. Möjliga värden är `limitedOrElevated` eller `elevated`. Standardvärdet är `limitedOrElevated`.

Import

Elementet Imports beskriver en samling importmoduler för en webbroll som lägger till komponenter i gästoperativsystemet. Det här elementet är överordnat för elementet Import . Det här elementet är valfritt och en roll kan bara ha ett importblock.

- Imports elementet är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

Importera

Elementet Import anger en modul som ska läggas till i gästoperativsystemet.

- Import elementet är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

I följande tabell beskrivs elementets Import attribut.

Attribut	Typ	Beskrivning
moduleName	sträng	Krävs. Namnet på modulen som ska importeras. Giltiga importmoduler är: -Remoteaccess - RemoteForwarder -Diagnostik Med modulerna RemoteAccess och RemoteForwarder kan du konfigurera rollinstansen för fjärrskrivbordsanslutningar. Mer information finns i Aktivera anslutning till fjärrskrivbord. Med modulen Diagnostik kan du samla in diagnostikdata för en rollinstans.

Körning

Elementet Runtime beskriver en samling miljövariabelinställningar för en webbroll som styr körningsmiljön i Azure-värdprocessen. Det här elementet är överordnat för elementet Environment . Det här elementet är valfritt och en roll kan bara ha ett körningsblock.

- Runtime elementet är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

I följande tabell beskrivs elementets Runtime attribut:

Attribut	Typ	Beskrivning
executionContext	sträng	Valfritt. Anger i vilken kontext rollprocessen startas. Standardkontexten är `limited`. - `limited` – Processen startas utan administratörsbehörighet. - `elevated` – Processen startas med administratörsbehörighet.

Miljö

Elementet Environment beskriver en samling miljövariabelinställningar för en webbroll. Det här elementet är överordnat för elementet Variable . En roll kan ha valfritt antal miljövariabler angivna.

Variabel

Elementet Variable anger en miljövariabel som ska anges i gästdriften.

- Variable elementet är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

I följande tabell beskrivs elementets Variable attribut:

Attribut	Typ	Beskrivning
name	sträng	Krävs. Namnet på miljövariabeln som ska anges.
värde	sträng	Valfritt. Värdet som ska anges för miljövariabeln. Du måste inkludera antingen ett värdeattribut eller ett `RoleInstanceValue` element.

RoleInstanceValue

Elementet RoleInstanceValue anger xPath som värdet för variabeln ska hämtas från.

I följande tabell beskrivs elementets RoleInstanceValue attribut.

Attribut	Typ	Beskrivning
Xpath	sträng	Valfritt. Platssökväg för distributionsinställningar för instansen. Mer information finns i Konfigurationsvariabler med XPath. Du måste inkludera antingen ett värdeattribut eller ett `RoleInstanceValue` element.

EntryPoint

Elementet EntryPoint anger startpunkten för en roll. Det här elementet är överordnat för elementen NetFxEntryPoint . Med de här elementen kan du ange ett annat program än standard WaWorkerHost.exe att fungera som rollinmatningspunkt.

- EntryPoint elementet är endast tillgängligt med hjälp av Azure SDK version 1.5 eller senare.

NetFxEntryPoint

Elementet NetFxEntryPoint anger vilket program som ska köras för en roll.

Anteckning

- NetFxEntryPoint elementet är endast tillgängligt med hjälp av Azure SDK version 1.5 eller senare.

I följande tabell beskrivs elementets NetFxEntryPoint attribut.

Attribut	Typ	Beskrivning
assemblyName	sträng	Krävs. Sökvägen och filnamnet för sammansättningen som innehåller startpunkten. Sökvägen är relativ till mappen \%ROLEROOT%\Approot (ange inte \%ROLEROOT%\Approot i `commandLine`, det antas). %ROLEROOT% är en miljövariabel som underhålls av Azure och representerar rotmappens plats för din roll. Mappen \%ROLEROOT%\Approot representerar programmappen för din roll. För HWC-roller är sökvägen alltid relativ till mappen \%ROLEROOT%\Approot\bin . Om det inte går att hitta sammansättningen i förhållande till mappen \%ROLEROOT%\Approot för fullständiga IIS- och IIS Express webbroller genomsöks mappen \%ROLEROOT%\Approot\bin. Det här tillbakafallsbeteendet för fullständig IIS är inte en rekommenderad metod och kanske tas bort i framtida versioner.
targetFrameworkVersion	sträng	Krävs. Versionen av .NET-ramverket som sammansättningen skapades på. Till exempel `targetFrameworkVersion="v4.0"`.

Webbplatser

Elementet Sites beskriver en samling webbplatser och webbprogram som finns i en webbroll. Det här elementet är överordnat för elementet Site . Om du inte anger ett Sites element hanteras webbrollen som en äldre webbroll och du kan bara ha en webbplats i webbrollen. Det här elementet är valfritt och en roll kan bara ha ett platsblock.

- Sites elementet är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

Webbplats

Elementet Site anger en webbplats eller ett webbprogram som ingår i webbrollen.

- Site elementet är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

I följande tabell beskrivs elementets Site attribut.

Attribut	Typ	Beskrivning
name	sträng	Krävs. Namnet på webbplatsen eller programmet.
physicalDirectory	sträng	Platsen för innehållskatalogen för platsroten. Platsen kan anges som en absolut sökväg eller i förhållande till .csdef-platsen.

VirtualApplication

Elementet VirtualApplication definierar ett program i Internet Information Services (IIS) 7 är en gruppering av filer som levererar innehåll eller tillhandahåller tjänster över protokoll, till exempel HTTP. När du skapar ett program i IIS 7 blir programmets sökväg en del av webbplatsens URL.

- VirtualApplication elementet är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

I följande tabell beskrivs elementets VirtualApplication attribut.

Attribut	Typ	Beskrivning
name	sträng	Krävs. Anger ett namn för att identifiera det virtuella programmet.
physicalDirectory	sträng	Krävs. Anger sökvägen på utvecklingsdatorn som innehåller det virtuella programmet. I beräkningsemulatorn är IIS konfigurerat för att hämta innehåll från den här platsen. När du distribuerar till Azure paketeras innehållet i den fysiska katalogen tillsammans med resten av tjänsten. När tjänstpaketet distribueras till Azure konfigureras IIS med platsen för det uppackade innehållet.

VirtualDirectory

Elementet VirtualDirectory anger ett katalognamn (kallas även sökväg) som du anger i IIS och mappar till en fysisk katalog på en lokal server eller fjärrserver.

- VirtualDirectory elementet är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

I följande tabell beskrivs elementets VirtualDirectory attribut.

Attribut	Typ	Beskrivning
name	sträng	Krävs. Anger ett namn för att identifiera den virtuella katalogen.
värde	physicalDirectory	Krävs. Anger sökvägen på utvecklingsdatorn som innehåller webbplatsen eller innehållet i den virtuella katalogen. I beräkningsemulatorn är IIS konfigurerat för att hämta innehåll från den här platsen. När du distribuerar till Azure paketeras innehållet i den fysiska katalogen tillsammans med resten av tjänsten. När tjänstpaketet distribueras till Azure konfigureras IIS med platsen för det uppackade innehållet.

Bindningar

Elementet Bindings beskriver en samling bindningar för en webbplats. Det är elementets Binding överordnade element. Elementet krävs för varje Site element. Mer information om hur du konfigurerar slutpunkter finns i Aktivera kommunikation för rollinstanser.

- Bindings elementet är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

Bindning

Elementet Binding anger konfigurationsinformation som krävs för förfrågningar om att kommunicera med en webbplats eller ett webbprogram.

- Binding elementet är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

Attribut	Typ	Beskrivning
name	sträng	Krävs. Anger ett namn för att identifiera bindningen.
endpointName	sträng	Krävs. Anger det slutpunktsnamn som ska bindas till.
hostHeader	sträng	Valfritt. Anger ett värdnamn som gör att du kan vara värd för flera platser, med olika värdnamn, på en enda KOMBINATION av IP-adress/portnummer.

Start

Elementet Startup beskriver en samling aktiviteter som körs när rollen startas. Det här elementet kan vara överordnat för -elementet Variable . Mer information om hur du använder rollstartaktiviteter finns i Så här konfigurerar du startuppgifter. Det här elementet är valfritt och en roll kan bara ha ett startblock.

I följande tabell beskrivs -attributet för -elementet Startup .

Attribut	Typ	Beskrivning
prioritet	int	Endast för internt bruk.

Uppgift

Elementet Task anger startaktiviteten som äger rum när rollen startar. Startuppgifter kan användas för att utföra uppgifter som förbereder rollen för att köra sådana installationsprogramkomponenter eller köra andra program. Aktiviteter körs i den ordning som de visas i elementblocket Startup .

- Task elementet är endast tillgängligt med hjälp av Azure SDK version 1.3 eller senare.

I följande tabell beskrivs elementets Task attribut.

Attribut	Typ	Beskrivning
Kommandorad	sträng	Krävs. Ett skript, till exempel en CMD-fil, som innehåller de kommandon som ska köras. Startkommandot och batchfilerna måste sparas i ANSI-format. Filformat som anger en byteordningsmarkör i början av filen kommer inte att bearbetas korrekt.
executionContext	sträng	Anger i vilken kontext skriptet körs. - `limited` [Standard] – Kör med samma behörigheter som rollen som värd för processen. - `elevated` – Kör med administratörsbehörighet.
taskType	sträng	Anger körningsbeteendet för kommandot. - `simple` [Standard] – Systemet väntar på att aktiviteten ska avslutas innan andra aktiviteter startas. - `background` – Systemet väntar inte på att aktiviteten ska avslutas. - `foreground` – Liknar bakgrunden, förutom att rollen inte startas om förrän alla förgrundsaktiviteter avslutas.

Innehåll

Elementet Contents beskriver samlingen med innehåll för en webbroll. Det här elementet är det överordnade elementet Content .

Elementet Contents är endast tillgängligt med hjälp av Azure SDK version 1.5 eller senare.

Innehåll

Elementet Content definierar källplatsen för innehåll som ska kopieras till den virtuella Azure-datorn och målsökvägen som det kopieras till.

Elementet Content är endast tillgängligt med hjälp av Azure SDK version 1.5 eller senare.

I följande tabell beskrivs elementets Content attribut.

Attribut	Typ	Beskrivning
mål	sträng	Krävs. Plats på den virtuella Azure-dator som innehållet placeras på. Den här platsen är relativ till mappen %ROLEROOT%\Approot.

Det här elementet är elementets SourceDirectory överordnade element.

SourceDirectory

Elementet SourceDirectory definierar den lokala katalog som innehållet kopieras från. Använd det här elementet för att ange det lokala innehållet som ska kopieras till den virtuella Azure-datorn.

Elementet SourceDirectory är endast tillgängligt med hjälp av Azure SDK version 1.5 eller senare.

I följande tabell beskrivs elementets SourceDirectory attribut.

Attribut	Typ	Beskrivning
path	sträng	Krävs. Relativ eller absolut sökväg för en lokal katalog vars innehåll ska kopieras till den virtuella Azure-datorn. Utökning av miljövariabler i katalogsökvägen stöds.

Se även

Definitionsschema för molntjänst (klassisk)

WebRole-schema för Azure Cloud Services (klassisk) definition

Grundläggande tjänstdefinitionsschema för en webbroll

Schemaelement

WebRole

ConfigurationSettings

Inställning

LocalResources

Localstorage

Slutpunkter

InputEndpoint

InternalEndpoint

InstanceInputEndpoint

AllokeraPublicPortFrom

FixedPort

FixedPortRange

Certifikat

Certifikat

Import

Importera

Körning

Miljö

Variabel

RoleInstanceValue

EntryPoint

NetFxEntryPoint

Webbplatser

Webbplats

VirtualApplication

VirtualDirectory

Bindningar

Bindning

Start

Uppgift

Innehåll

Innehåll

SourceDirectory

Se även

Ytterligare resurser