Azure Cloud Services (genişletilmiş destek) tanımı WorkerRole şeması

Azure çalışan rolü, genelleştirilmiş geliştirme için yararlı olan ve bir web rolü için arka plan işleme gerçekleştirebilen bir roldür.

Hizmet tanımı dosyasının varsayılan uzantısı csdef'tir.

Çalışan rolü için temel hizmet tanımı şeması.

Çalışan rolü içeren hizmet tanımı dosyasının temel biçimi aşağıdaki gibidir.

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

Şema öğeleri

Hizmet tanımı dosyası, bu konunun sonraki bölümlerinde ayrıntılı olarak açıklanan şu öğeleri içerir:

WorkerRole

Yapılandırma Ayarlar

Ayar

LocalResources

Yerel Depolama

Uç Noktalar

InputEndpoint

InternalEndpoint

InstanceInputEndpoint

AllocatePublicPortFrom

Sabit Bağlantı Noktası

FixedPortRange

Sertifikalar

Sertifika

Ithalat

İçeri Aktar

Çalışma Zamanı

Ortam

EntryPoint

NetFxEntryPoint

ProgramEntryPoint

Değişken

RoleInstanceValue

Startup

Görev

İçerik

İçerik

SourceDirectory

WorkerRole

WorkerRole öğesi, genelleştirilmiş geliştirme için yararlı olan bir rolü açıklar ve bir web rolü için arka plan işleme gerçekleştirebilir. Bir hizmet sıfır veya daha fazla çalışan rolü içerebilir.

Aşağıdaki tabloda öğesinin öznitelikleri WorkerRole açıklanmaktadır.

Öznitelik	Türü	Tanım
name	Dize	Gerekli. Çalışan rolünün adı. Rolün adı benzersiz olmalıdır.
enableNativeCodeExecution	boolean	isteğe bağlı. Varsayılan değerdir true; yerel kod yürütme ve tam güven varsayılan olarak etkinleştirilir. Çalışan rolü için yerel kod yürütmeyi devre dışı bırakmak ve bunun yerine Azure kısmi güveni kullanmak için bu özniteliği false olarak ayarlayın.
vmsize	Dize	isteğe bağlı. Bu role ayrılan sanal makinenin boyutunu değiştirmek için bu değeri ayarlayın. Small varsayılan değerdir. Olası sanal makine boyutlarının ve özniteliklerinin listesi için bkz . Cloud Services için Sanal Makine boyutları.

Yapılandırma Ayarlar

öğesi, ConfigurationSettings bir çalışan rolü için yapılandırma ayarlarının koleksiyonunu açıklar. Bu öğe, öğesinin Setting üst öğesidir.

Ayar

öğesi, Setting bir rolün örneği için yapılandırma ayarını belirten bir ad ve değer çiftini açıklar.

Aşağıdaki tabloda öğesinin öznitelikleri Setting açıklanmaktadır.

Öznitelik	Türü	Tanım
name	Dize	Gerekli. Yapılandırma ayarı için benzersiz bir ad.

Bir rolün yapılandırma ayarları, hizmet tanımı dosyasında bildirilen ve hizmet yapılandırma dosyasında ayarlanan ad ve değer çiftleridir.

LocalResources

öğesi, LocalResources bir çalışan rolü için yerel depolama kaynaklarının koleksiyonunu açıklar. Bu öğe, öğesinin LocalStorage üst öğesidir.

Yerel Depolama

öğesi, LocalStorage çalışma zamanında hizmet için dosya sistemi alanı sağlayan yerel bir depolama kaynağı tanımlar. Bir rol sıfır veya daha fazla yerel depolama kaynağı tanımlayabilir.

Dekont

öğesi, Azure SDK'nın LocalStorage WorkerRole önceki sürümleriyle uyumluluğu desteklemek için öğesinin alt öğesi olarak görünebilir.

Aşağıdaki tabloda öğesinin öznitelikleri LocalStorage açıklanmaktadır.

Öznitelik	Türü	Tanım
name	Dize	Gerekli. Yerel mağaza için benzersiz bir ad.
cleanOnRoleRecycle	boolean	isteğe bağlı. Rol yeniden başlatıldığında yerel deponun temizlenip temizlenmeyeceğini gösterir. Varsayılan değer true olarak belirlenmiştir.
sizeInMb	int	isteğe bağlı. Mb cinsinden yerel depo için ayrılacak istenen depolama alanı miktarı. Belirtilmezse, ayrılan varsayılan depolama alanı 100 MB'tır. Ayrılabilecek en düşük depolama alanı miktarı 1 MB'tır. Yerel kaynakların en büyük boyutu sanal makine boyutuna bağlıdır. Daha fazla bilgi için bkz . Cloud Services için Sanal Makine boyutları.

Yerel depolama kaynağına ayrılan dizinin adı, name özniteliği için sağlanan değere karşılık gelir.

Uç Noktalar

öğesi, Endpoints bir rol için giriş (dış), iç ve örnek giriş uç noktalarının koleksiyonunu açıklar. Bu öğe , InternalEndpointve InstanceInputEndpoint öğelerinin InputEndpointüst öğesidir.

Giriş ve İç uç noktalar ayrı ayrı ayrılır. Bir hizmette izin verilen 25 rol arasında ayrılabilen toplam 25 giriş, iç ve örnek giriş uç noktası olabilir. Örneğin, 5 rol varsa rol başına 5 giriş uç noktası ayırabilir veya tek bir role 25 giriş uç noktası ayırabilir veya her biri 25 role 1 giriş uç noktası ayırabilirsiniz.

Dekont

Dağıtılan her rol için rol başına bir örnek gerekir. Bir abonelik için varsayılan sağlama 20 çekirdekle sınırlıdır ve bu nedenle bir rolün 20 örneğiyle sınırlıdır. Uygulamanız varsayılan sağlama tarafından sağlanandan daha fazla örnek gerektiriyorsa kotanızı artırma hakkında daha fazla bilgi için bkz . Faturalama, Abonelik Yönetimi ve Kota Desteği .

InputEndpoint

öğesi, InputEndpoint bir çalışan rolü için dış uç noktayı açıklar.

HTTP, HTTPS, UDP ve TCP uç noktalarının birleşimi olan birden çok uç nokta tanımlayabilirsiniz. Giriş uç noktası için seçtiğiniz herhangi bir bağlantı noktası numarasını belirtebilirsiniz, ancak hizmetteki her rol için belirtilen bağlantı noktası numaraları benzersiz olmalıdır. Örneğin, bir rolün HTTP için 80, HTTPS için 443 numaralı bağlantı noktasını kullandığını belirtirseniz, ikinci bir rolün HTTP için 8080, HTTPS için 8043 numaralı bağlantı noktasını kullandığını belirtebilirsiniz.

Aşağıdaki tabloda öğesinin öznitelikleri InputEndpoint açıklanmaktadır.

Öznitelik	Türü	Tanım
name	Dize	Gerekli. Dış uç nokta için benzersiz bir ad.
Protokolü	Dize	Gerekli. Dış uç nokta için aktarım protokolü. Bir çalışan rolü için olası değerler , , HTTPSUDPveya TCPşeklindedirHTTP.
port	int	Gerekli. Dış uç noktanın bağlantı noktası. Seçtiğiniz herhangi bir bağlantı noktası numarasını belirtebilirsiniz, ancak hizmetteki her rol için belirtilen bağlantı noktası numaraları benzersiz olmalıdır. Olası değerler 1 ile 65535 (azure SDK sürüm 1.7 veya üzeri) arasında değişir.
sertifika	Dize	HTTPS uç noktası için gereklidir. Bir öğe tarafından tanımlanan sertifikanın Certificate adı.
localPort	int	isteğe bağlı. Uç nokta üzerindeki iç bağlantılar için kullanılan bir bağlantı noktasını belirtir. özniteliği, localPort uç nokta üzerindeki dış bağlantı noktasını bir roldeki iç bağlantı noktasıyla eşler. Bu, bir rolün dış kullanıma sunulandan farklı bir bağlantı noktasındaki bir iç bileşenle iletişim kurması gereken senaryolarda kullanışlıdır. Belirtilmezse değeri localPort özniteliğiyle port aynıdır. Çalışma zamanı API'sini localPort kullanarak bulunabilen ayrılmamış bir bağlantı noktasını otomatik olarak atamak için değerini "*" olarak ayarlayın. Olası değerler 1 ile 65535 (azure SDK sürüm 1.7 veya üzeri) arasında değişir. localPort Özniteliği yalnızca Azure SDK sürüm 1.3 veya üzeri kullanılarak kullanılabilir.
ignoreRoleInstanceStatus	boolean	isteğe bağlı. Bu özniteliğin değeri olarak trueayarlandığında hizmetin durumu yoksayılır ve uç nokta yük dengeleyici tarafından kaldırılmaz. Bir hizmetin meşgul örneklerinde hata ayıklamak için bu değeri true yararlı olacak şekilde ayarlayın. false varsayılan değerdir. Not: Rol Hazır durumda olmasa bile uç nokta trafiği almaya devam edebilir.
loadBalancerProbe	Dize	isteğe bağlı. Giriş uç noktasıyla ilişkili yük dengeleyici yoklaması adı. Daha fazla bilgi için bkz . LoadBalancerProbe Şeması.

InternalEndpoint

öğesi, InternalEndpoint bir çalışan rolü için iç uç noktayı açıklar. İç uç nokta yalnızca hizmet içinde çalışan diğer rol örnekleri tarafından kullanılabilir; hizmet dışındaki istemciler tarafından kullanılamaz. Bir çalışan rolünün en fazla beş HTTP, UDP veya TCP iç uç noktası olabilir.

Aşağıdaki tabloda öğesinin öznitelikleri InternalEndpoint açıklanmaktadır.

Öznitelik	Türü	Tanım
name	Dize	Gerekli. İç uç nokta için benzersiz bir ad.
Protokolü	Dize	Gerekli. İç uç nokta için aktarım protokolü. Olası değerler HTTP: , TCP, UDPveya ANY. değeri ANY , herhangi bir protokole, herhangi bir bağlantı noktasına izin verildiğini belirtir.
port	int	isteğe bağlı. Uç nokta üzerindeki iç yük dengeli bağlantılar için kullanılan bağlantı noktası. Yük dengeli uç nokta iki bağlantı noktası kullanır. Genel IP adresi için kullanılan bağlantı noktası ve özel IP adresinde kullanılan bağlantı noktası. Bunlar genellikle aynı şekilde ayarlanır, ancak farklı bağlantı noktaları kullanmayı seçebilirsiniz. Olası değerler 1 ile 65535 (azure SDK sürüm 1.7 veya üzeri) arasında değişir. Port Özniteliği yalnızca Azure SDK sürüm 1.3 veya üzeri kullanılarak kullanılabilir.

InstanceInputEndpoint

öğesi, InstanceInputEndpoint çalışan rolüne örnek giriş uç noktasını açıklar. Örnek giriş uç noktası, yük dengeleyicide bağlantı noktası iletme kullanılarak belirli bir rol örneğiyle ilişkilendirilir. Her örnek giriş uç noktası, bir dizi olası bağlantı noktasından belirli bir bağlantı noktasına eşlenir. Bu öğe, öğesinin AllocatePublicPortFrom üst öğesidir.

InstanceInputEndpoint öğesi yalnızca Azure SDK sürüm 1.7 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri InstanceInputEndpoint açıklanmaktadır.

Öznitelik	Türü	Tanım
name	Dize	Gerekli. Uç nokta için benzersiz bir ad.
localPort	int	Gerekli. Yük dengeleyiciden iletilen gelen trafiği almak için tüm rol örneklerinin dinleyeceği iç bağlantı noktasını belirtir. Olası değerler 1 ile 65535 (dahil) arasında değişir.
Protokolü	Dize	Gerekli. İç uç nokta için aktarım protokolü. Olası değerler: udp veya tcp. http/https tabanlı trafik için kullanın tcp .

AllocatePublicPortFrom

öğesi, AllocatePublicPortFrom dış müşteriler tarafından her örnek giriş uç noktasına erişmek için kullanılabilecek genel bağlantı noktası aralığını açıklar. Genel (VIP) bağlantı noktası numarası bu aralıktan ayrılır ve kiracı dağıtımı ve güncelleştirmesi sırasında her bir rol örneği uç noktasına atanır. Bu öğe, öğesinin FixedPortRange üst öğesidir.

AllocatePublicPortFrom öğesi yalnızca Azure SDK sürüm 1.7 veya üzeri kullanılarak kullanılabilir.

Sabit Bağlantı Noktası

FixedPort öğesi, iç uç noktanın bağlantı noktasını belirtir ve bu da uç noktada yük dengeli bağlantıları etkinleştirir.

FixedPort öğesi yalnızca Azure SDK sürüm 1.3 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri FixedPort açıklanmaktadır.

Öznitelik	Türü	Tanım
port	int	Gerekli. İç uç noktanın bağlantı noktası. Bu, min ve max değerlerini aynı bağlantı noktasına ayarlamakla FixedPortRange aynı etkiye sahiptir. Olası değerler 1 ile 65535 (azure SDK sürüm 1.7 veya üzeri) arasında değişir.

FixedPortRange

öğesi, FixedPortRange iç uç noktaya veya örnek giriş uç noktasına atanan bağlantı noktası aralığını belirtir ve uç noktada yük dengeli bağlantılar için kullanılan bağlantı noktasını ayarlar.

Dekont

öğesi, FixedPortRange içinde bulunduğu öğeye bağlı olarak farklı çalışır. öğesi öğesinde olduğunda, rolün FixedPortRange InternalEndpoint çalıştığı tüm sanal makineler için en düşük ve en yüksek öznitelik aralığındaki yük dengeleyicideki tüm bağlantı noktalarını açar. FixedPortRange öğesi öğesinde InstanceInputEndpoint olduğunda, rolü çalıştıran her sanal makinede min ve max öznitelikleri aralığında yalnızca bir bağlantı noktası açar.

FixedPortRange öğesi yalnızca Azure SDK sürüm 1.3 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri FixedPortRange açıklanmaktadır.

Öznitelik	Türü	Tanım
min	int	Gerekli. Aralıktaki en düşük bağlantı noktası. Olası değerler 1 ile 65535 (azure SDK sürüm 1.7 veya üzeri) arasında değişir.
max	Dize	Gerekli. Aralıktaki en yüksek bağlantı noktası. Olası değerler 1 ile 65535 (azure SDK sürüm 1.7 veya üzeri) arasında değişir.

Sertifikalar

öğesi, Certificates bir çalışan rolü için sertifika koleksiyonunu açıklar. Bu öğe, öğesinin Certificate üst öğesidir. Bir rolün herhangi bir sayıda ilişkili sertifikası olabilir. certificates öğesini kullanma hakkında daha fazla bilgi için bkz . Hizmet Tanımı dosyasını bir sertifikayla değiştirme.

Sertifika

öğesi, Certificate çalışan rolüyle ilişkili bir sertifikayı açıklar.

Aşağıdaki tabloda öğesinin öznitelikleri Certificate açıklanmaktadır.

Öznitelik	Türü	Tanım
name	Dize	Gerekli. Bir HTTPS InputEndpoint öğesiyle ilişkilendirildiğinde bu sertifikaya başvurmak için kullanılan bu sertifikanın adı.
Storelocation	Dize	Gerekli. Bu sertifikanın yerel makinede bulunabileceği sertifika deposunun konumu. Olası değerler ve LocalMachineşeklindedirCurrentUser.
Storename	Dize	Gerekli. Bu sertifikanın yerel makinede bulunduğu sertifika deposunun adı. Olası değerler yerleşik depo adları My, , Root, CA, Trust, , Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, , AddressBookveya herhangi bir özel depo adıdır. Özel bir mağaza adı belirtilirse, mağaza otomatik olarak oluşturulur.
permissionLevel	Dize	isteğe bağlı. Rol işlemlerine verilen erişim izinlerini belirtir. Yalnızca yükseltilmiş işlemlerin özel anahtara erişebilmesini istiyorsanız, izin belirtin elevated . limitedOrElevated izni, tüm rol işlemlerinin özel anahtara erişmesini sağlar. Olası değerler: limitedOrElevated veya elevated. limitedOrElevated varsayılan değerdir.

İçeri aktarmalar

öğesi, Imports konuk işletim sistemine bileşen ekleyen bir çalışan rolü için içeri aktarma modülleri koleksiyonunu açıklar. Bu öğe, öğesinin Import üst öğesidir. Bu öğe isteğe bağlıdır ve bir rolün yalnızca bir çalışma zamanı bloğu olabilir.

Imports öğesi yalnızca Azure SDK sürüm 1.3 veya üzeri kullanılarak kullanılabilir.

İçe aktar

öğesi, Import konuk işletim sistemine eklenecek modülü belirtir.

Import öğesi yalnızca Azure SDK sürüm 1.3 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri Import açıklanmaktadır.

Öznitelik	Türü	Tanım
Modulename	Dize	Gerekli. İçeri aktaracak modülün adı. Geçerli içeri aktarma modülleri şunlardır: -Remoteaccess - RemoteForwarder -Tanılama RemoteAccess ve RemoteForwarder modülleri, rol örneğinizi uzak masaüstü bağlantıları için yapılandırmanıza olanak tanır. Daha fazla bilgi için bkz . Uzantılar. Tanılama modülü, rol örneği için tanılama verileri toplamanıza olanak tanır

Çalışma Zamanı

öğesi, Runtime Azure konak işleminin çalışma zamanı ortamını denetleen bir çalışan rolü için ortam değişkeni ayarları koleksiyonunu açıklar. Bu öğe, öğesinin Environment üst öğesidir. Bu öğe isteğe bağlıdır ve bir rolün yalnızca bir çalışma zamanı bloğu olabilir.

Runtime öğesi yalnızca Azure SDK sürüm 1.3 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri Runtime açıklanmaktadır:

Öznitelik	Türü	Tanım
Executioncontext	Dize	isteğe bağlı. Rol İşleminin başlatıldığı bağlamı belirtir. Varsayılan bağlamdır limited. - limited– İşlem, Yönetici istrator ayrıcalıkları olmadan başlatılır. - elevated– İşlem Yönetici istrator ayrıcalıklarıyla başlatılır.

Ortam

öğesi, Environment bir çalışan rolü için ortam değişkeni ayarları koleksiyonunu açıklar. Bu öğe, öğesinin Variable üst öğesidir. Bir rolün ayarlanmış herhangi bir sayıda ortam değişkeni olabilir.

Değişken

öğesi, Variable konuk işletiminde ayarlanacağı ortam değişkenini belirtir.

Variable öğesi yalnızca Azure SDK sürüm 1.3 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri Variable açıklanmaktadır:

Öznitelik	Türü	Tanım
name	Dize	Gerekli. Ayarlanacağı ortam değişkeninin adı.
value	Dize	isteğe bağlı. Ortam değişkeni için ayarlanacağı değer. Bir değer özniteliği veya RoleInstanceValue öğesi eklemeniz gerekir.

RoleInstanceValue

öğesi, RoleInstanceValue değişkenin değerinin alındığı xPath'i belirtir.

Aşağıdaki tabloda öğesinin öznitelikleri RoleInstanceValue açıklanmaktadır.

Öznitelik	Türü	Tanım
Xpath	Dize	isteğe bağlı. Örnek için dağıtım ayarlarının konum yolu. Daha fazla bilgi için bkz . XPath ile yapılandırma değişkenleri. Bir değer özniteliği veya RoleInstanceValue öğesi eklemeniz gerekir.

EntryPoint

EntryPoint öğesi bir rolün giriş noktasını belirtir. Bu öğe, öğelerin üst öğesidir NetFxEntryPoint . Bu öğeler, rol giriş noktası olarak görev yapmak için varsayılan WaWorkerHost.exe dışında bir uygulama belirtmenize olanak sağlar.

EntryPoint öğesi yalnızca Azure SDK sürüm 1.5 veya üzeri kullanılarak kullanılabilir.

NetFxEntryPoint

öğesi, NetFxEntryPoint bir rol için çalıştırılacak programı belirtir.

Dekont

NetFxEntryPoint öğesi yalnızca Azure SDK sürüm 1.5 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri NetFxEntryPoint açıklanmaktadır.

Öznitelik	Türü	Tanım
Assemblyname	Dize	Gerekli. Giriş noktasını içeren derlemenin yolu ve dosya adı. Yol \%ROLEROOT%\Approot klasörüne göredir (içinde commandLine\%ROLEROOT%\Approot belirtmeyin) olduğu varsayılır. %ROLEROOT% , Azure tarafından tutulan bir ortam değişkenidir ve rolünüz için kök klasör konumunu temsil eder. \%ROLEROOT%\Approot klasörü, rolünüz için uygulama klasörünü temsil eder.
targetFrameworkVersion	Dize	Gerekli. Derlemenin oluşturulduğu .NET framework sürümü. Örneğin, targetFrameworkVersion="v4.0".

ProgramEntryPoint

öğesi, ProgramEntryPoint bir rol için çalıştırılacak programı belirtir. öğesi, ProgramEntryPoint .NET derlemesine dayalı olmayan bir program giriş noktası belirtmenize olanak tanır.

Dekont

ProgramEntryPoint öğesi yalnızca Azure SDK sürüm 1.5 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri ProgramEntryPoint açıklanmaktadır.

Öznitelik	Türü	Tanım
Commandline	Dize	Gerekli. Yürütülecek programın yolu, dosya adı ve komut satırı bağımsız değişkenleri. Yol % ROLEROOT%\Approot klasörüne göredir (commandLine içinde %ROLEROOT%\Approot belirtmeyin, varsayılır). %ROLEROOT% , Azure tarafından tutulan bir ortam değişkenidir ve rolünüz için kök klasör konumunu temsil eder. %ROLEROOT%\Approot klasörü, rolünüz için uygulama klasörünü temsil eder. Program sona ererse rol geri dönüştürülür, bu nedenle genellikle programı yalnızca başlatıp sonlu bir görev çalıştıran bir program olmak yerine çalışmaya devam etmek üzere ayarlayın.
setReadyOnProcessStart	boolean	Gerekli. Rol örneğinin komut satırı programının başlatılıp başlatılmadığını bildirmesini bekleyip beklemediğini belirtir. Bu değer şu anda olarak true ayarlanmalıdır. değerini false olarak ayarlamak, gelecekte kullanmak üzere ayrılmıştır.

Başlangıç

öğesi, Startup rol başlatıldığında çalışan bir görev koleksiyonunu açıklar. Bu öğe öğenin üst Variable öğesi olabilir. Rol başlangıç görevlerini kullanma hakkında daha fazla bilgi için bkz . Başlangıç görevlerini yapılandırma. Bu öğe isteğe bağlıdır ve bir rolün yalnızca bir başlangıç bloğu olabilir.

Aşağıdaki tabloda öğesinin özniteliği Startup açıklanmaktadır.

Öznitelik	Türü	Tanım
Öncelik	int	Yalnızca dahili kullanım içindir.

Görev

öğesi, Task rol başlatıldığında gerçekleşen başlangıç görevini belirtir. Başlangıç görevleri, bu tür yükleme yazılım bileşenlerini çalıştırmak veya diğer uygulamaları çalıştırmak için rolü hazırlayan görevleri gerçekleştirmek için kullanılabilir. Görevler, öğe bloğu içinde göründükleri Startup sırayla yürütülür.

Task öğesi yalnızca Azure SDK sürüm 1.3 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri Task açıklanmaktadır.

Öznitelik	Türü	Tanım
Commandline	Dize	Gerekli. Çalıştırılacak komutları içeren CMD dosyası gibi bir betik. Başlangıç komutu ve toplu iş dosyaları ANSI biçiminde kaydedilmelidir. Dosyanın başında bayt sırası işaretçisi ayarlayan dosya biçimleri düzgün işlenmez.
Executioncontext	Dize	Betiğin çalıştırıldığı bağlamı belirtir. - limited [Varsayılan] – İşlemi barındıran rolle aynı ayrıcalıklarla çalıştırın. - elevated – Yönetici ayrıcalıklarıyla çalıştırın.
Tasktype	Dize	Komutun yürütme davranışını belirtir. - simple [Varsayılan] – Sistem, diğer görevler başlatılmadan önce görevin çıkmasını bekler. - background – Sistem görevin çıkmasını beklemez. - foreground – Arka plana benzer, ancak tüm ön plan görevleri çıkana kadar rol yeniden başlatılmaz.

İçindekiler

öğesi, Contents bir çalışan rolü için içerik koleksiyonunu açıklar. Bu öğe, öğesinin Content üst öğesidir.

Contents öğesi yalnızca Azure SDK sürüm 1.5 veya üzeri kullanılarak kullanılabilir.

İçerik

öğesi, Content Azure sanal makinesine kopyalanacak içeriğin kaynak konumunu ve kopyalandığı hedef yolu tanımlar.

Content öğesi yalnızca Azure SDK sürüm 1.5 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri Content açıklanmaktadır.

Öznitelik	Türü	Tanım
destination	Dize	Gerekli. İçeriğin yerleştirildiği Azure sanal makinesindeki konum. Bu konum %ROLEROOT%\Approot klasörüne göredir.

Bu öğe, öğesinin SourceDirectory üst öğesidir.

SourceDirectory

öğesi, SourceDirectory içeriğin kopyalandığı yerel dizini tanımlar. Azure sanal makinesine kopyalanacak yerel içeriği belirtmek için bu öğeyi kullanın.

SourceDirectory öğesi yalnızca Azure SDK sürüm 1.5 veya üzeri kullanılarak kullanılabilir.

Aşağıdaki tabloda öğesinin öznitelikleri SourceDirectory açıklanmaktadır.

Öznitelik	Türü	Tanım
yol	Dize	Gerekli. İçeriği Azure sanal makinesine kopyalanacak yerel dizinin göreli veya mutlak yolu. Dizin yolunda ortam değişkenlerinin genişletilmesi desteklenir.

Ayrıca bkz.

Bulut Hizmeti (genişletilmiş destek) Tanım Şeması.