Questa pagina è stata utile?
I suggerimenti relativi al contenuto di questa pagina sono importanti. Comunicaceli.
Altri suggerimenti?
1500 caratteri rimanenti
MSDN Library

Aggiungi ruolo

Aggiornamento: luglio 2015

Tramite l'operazione Add Role viene aggiunta una macchina virtuale a una relativa distribuzione. Prima di eseguire questa operazione, è necessario disporre di un servizio cloud e una distribuzione esistenti in Microsoft Azure. Per creare un servizio cloud, è possibile usare la relativa procedura. Per creare una distribuzione, è possibile creare la distribuzione di una macchina virtuale.

La richiesta di Add Role può essere specificata come indicato di seguito. Sostituire <subscription-id> con il proprio ID sottoscrizione, <cloudservice-name> con il nome del servizio cloud e <deployment-name> con il nome della distribuzione.

 

Metodo URI della richiesta

POST

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/roles

È necessario verificare che la richiesta eseguita al servizio di gestione sia sicura. Per altri dettagli, vedere Autenticazione di richieste di gestione dei servizi.

Nessuno.

La tabella seguente descrive le intestazioni della richiesta.

 

Intestazione della richiesta Descrizione

Content-Type

Obbligatorio. Impostare questa intestazione su application/xml.

x-ms-version

Obbligatorio. Specifica la versione dell'operazione da usare per questa richiesta. Questa intestazione deve essere impostata su 2014-10-01 o una versione successiva. Per altre informazioni sulle intestazioni di controllo delle versioni, vedere Controllo delle versioni relativo alla gestione dei servizi.

Il formato del corpo della richiesta è il seguente:


<PersistentVMRole xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <RoleName>name-of-the-virtual-machine</RoleName>
  <RoleType>PersistentVMRole</RoleType>
  <ConfigurationSets>
    <ConfigurationSet i:type="WindowsProvisioningConfigurationSet">
      <ConfigurationSetType>WindowsProvisioningConfiguration</ConfigurationType> 
      <ComputerName>name-of-computer</ComputerName>
      <AdminPassword>administrator-password</AdminPassword> 
      <EnableAutomaticUpdates>enable-updates</EnableAutomaticUpdates>  
      <TimeZone>time-zone</TimeZone>
      <DomainJoin>
        <Credentials>
          <Domain>domain-to-join</Domain>
          <Username>user-name-in-the-domain</Username>
          <Password>password-for-the-user-name</Password>
        </Credentials>
        <JoinDomain>domain-to-join</JoinDomain>
        <MachineObjectOU>distinguished-name-of-the-ou</MachineObjectOU>
      </DomainJoin>
      <StoredCertificateSettings>
        <CertificateSetting>
          <StoreLocation>LocalMachine</StoreLocation>
          <StoreName>name-of-store-on-the-machine</StoreName>
          <Thumbprint>certificate-thumbprint</Thumbprint>
        </CertificateSetting>
      </StoredCertificateSettings>
      <WinRM>
        <Listeners>
          <Listener>
            <Protocol>listener-protocol</Protocol>
          </Listener>
          <Listener>
            <CertificateThumbprint>certificate-thumbprint</CertificateThumbprint>
            <Protocol>listener-protocol</Protocol>
          </Listener>
        </Listeners>
      </WinRM>
      <AdminUsername>name-of-administrator-account</AdminUsername>
      <CustomData>base-64-encoded-data</CustomData>
      <AdditionalUnattendContent>
        <Passes>
          <UnattendPass>
            <PassName>name-of-pass</PassName>
            <Components>
              <UnattendComponent>
                <ComponentName>name-of-component</ComponentName>
                <ComponentSettings>
                  <ComponentSetting>
                    <SettingName>name-of-setting</SettingName>
                    <Content>base-64-encoded-XML-content</Content>
                  </ComponentSetting>
                </ComponentSettings>
              </UnattendComponent>
            </Components>
          </UnattendPass>
        </Passes>
      </AdditionalUnattendedContent>
    </ConfigurationSet>
    <ConfigurationSet i:type="LinuxProvisioningConfigurationSet">
      <ConfigurationSetType>LinuxProvisioningConfiguration</ConfigurationType>
      <HostName>host-name-for-the-virtual-machine</HostName>
      <UserName>new-user-name</UserName> 
      <UserPassword>password-for-the-new-user</UserPassword> 
      <DisableSshPasswordAuthentication>password-authentication</DisableSshPasswordAuthentication>           
      <SSH>
        <PublicKeys>
          <PublicKey>
            <FingerPrint>certificate-fingerprint</FingerPrint>
            <Path>SSH-public-key-storage-location</Path>     
          </PublicKey>
        </PublicKeys>
        <KeyPairs>
          <KeyPair>
            <FingerPrint>certificate-fingerprint</FingerPrint>
            <Path>SSH-public-key-storage-location</Path>
          </KeyPair>
        </KeyPairs>
      </SSH>
      <CustomData>base-64-encoded-data</CustomData>
    </ConfigurationSet>
    <ConfigurationSet>
      <ConfigurationSetType>NetworkConfiguration</ConfigurationSetType>          
      <InputEndpoints>
        <InputEndpoint>
          <LoadBalancedEndpointSetName>name-of-load-balanced-set</LoadBalancedEndpointSetName>
          <LocalPort>local-port-number</LocalPort>
          <Name>name-of-endpoint</Name>
          <Port>external-port-number</Port>
          <LoadBalancerProbe>
            <Path>path-of-probe</Path>
            <Port>port-assigned-to-probe</Port>
            <Protocol>probe-protocol</Protocol>
            <IntervalInSeconds>interval-of-probe</IntervalInSeconds>
            <TimeoutInSeconds>timeout-for-probe</TimeoutInSeconds>
          </LoadBalancerProbe>
          <Protocol>endpoint-protocol</Protocol>
          <EnableDirectServerReturn>enable-direct-server-return</EnableDirectServerReturn>
          <EndpointACL>
            <Rules>
              <Rule>
                <Order>priority-of-the-rule</Order>
                <Action>permit-rule</Action>
                <RemoteSubnet>subnet-of-the-rule</RemoteSubnet>
                <Description>description-of-the-rule</Description>
              </Rule>
            </Rules>
          </EndpointACL>
          <LoadBalancerName>name-of-internal-loadbalancer</LoadBalancerName>
          <IdleTimeoutInMinutes>timeout-for-tcp-idle-connection</IdleTimeoutInMinutes>  
        </InputEndpoint>
      </InputEndpoints>
      <SubnetNames>
        <SubnetName>name-of-subnet</SubnetName>
      </SubnetNames>
      <StaticVirtualNetworkIPAddress>ip-address</StaticVirtualNetworkIPAddress>
      <NetworkSecurityGroup>network-security-group</NetworkSecurityGroup>
      <PublicIPs>
        <PublicIP>
          <Name>name-of-public-ip</Name>
          <IdleTimeoutInMinutes>timeout-for-tcp-idle-connection</IdleTimeoutInMinutes>
          <DomainNameLabel>domain-label</DomainNameLabel>
        <PublicIP>
      <PublicIPs>
      <NetworkInterfaces>
        <NetworkInterface>
          <Name>interface-name</Name>
          <MacAddress>mac-address</MacAddress>
          <IPConfigurations>
            <IPConfiguration>
              <SubnetName>subnet-name</SubnetName>
              <Address>ip-address</Address>
            </IPConfiguration>
          <IPConfigurations>
        </NetworkInterface>
      </NetworkInterfaces>
    </ConfigurationSet>
  </ConfigurationSets>
  <ResourceExtensionReferences>
    <ResourceExtensionReference>
      <ReferenceName>name-of-reference</ReferenceName>
      <Publisher>name-of-publisher</Publisher>
      <Name>name-of-extension</Name>
      <Version>version-of-extension</Version>
      <ResourceExtensionParameterValues>
        <ResourceExtensionParameterValue>
          <Key>name-of-parameter-key</Key>
          <Value>parameter-value</Value>
          <Type>type-of-parameter</Type>
        </ResourceExtensionParameterValue>
      </ResourceExtensionParameterValues>
      <State>state-of-resource</State>
      <Certificates>
        <Certificate>
          <Thumbprint>certificate-thumbprint</Thumbprint>
          <ThumbprintAlgorithm>certificate-algorithm</ThumbprintAlgorithm>
        </Certificate>
      </Certificates>
    </ResourceExtensionReference>
  </ResourceExtensionReferences>
  <VMImageName>name-of-vm-image</VMImageName>
  <MediaLocation>path-to-vhd</MediaLocation>
  <AvailabilitySetName>name-of-availability-set</AvailabilitySetName>
  <DataVirtualHardDisks>
    <DataVirtualHardDisk>
      <HostCaching>caching-mode</HostCaching> 
      <DiskLabel>label-of-data-disk</DiskLabel>            
      <DiskName>name-of-disk</DiskName>
      <Lun>logical-unit-number</Lun>
      <LogicalDiskSizeInGB>size-in-gb-of-data-disk</LogicalDiskSizeInGB>            
      <MediaLink>path-to-vhd</MediaLink>
    </DataVirtualHardDisk>
  </DataVirtualHardDisks>
  <OSVirtualHardDisk>
    <HostCaching>caching-mode</HostCaching>    
    <DiskLabel>label-of-operating-system-disk</DiskLabel>
    <DiskName>name-of-disk</DiskName>                    
    <MediaLink>path-to-vhd</MediaLink>
    <SourceImageName>name-of-source-image</SourceImageName>
    <OS>operating-system-of-image</OS>
    <RemoteSourceImageLink>path-to-source-image</RemoteSourceImageLink>
    <ResizedSizeInGB>resized-size</ResizedSizeInGB>
  </OSVirtualHardDisk>      
  <RoleSize>size-of-virtual-machine</RoleSize>
  <ProvisionGuestAgent>install-an-agent</ProvisionGuestAgent>
  <VMImageInput>
    <OSDiskConfiguration>
      <ResizedSizeInGB>resized-size</ResizedSizeInGB>
    </OSDiskConfiguration>
    <DataDiskConfigurations>
      <DataDiskConfiguration>
        <Name>data-disk-name</Name>
        <ResizedSizeInGB>resized-size</ResizedSizeInGB>
      </DataDiskConfiguration>
    </DataDiskConfigurations>
  </VMImageInput>
</PersistentVMRole>

Nella tabella indicata di seguito vengono descritti gli elementi del corpo della richiesta.

 

Nome elemento Descrizione

RoleName

Obbligatorio. Specifica il nome della macchina virtuale.

RoleType

Obbligatorio. Specifica il tipo di ruolo da usare. Per le macchine virtuali, deve essere PersistentVMRole.

ConfigurationSets

Facoltativo. Contiene una raccolta di set di configurazione tramite cui vengono definite le impostazioni di configurazione dell'applicazione e di sistema.

ResourceExtensionReferences

Facoltativo. Contiene una raccolta di estensioni di risorsa da installare nella macchina virtuale. Questo elemento viene usato se ProvisionGuestAgent è impostato su true.

L'elemento ResourceExtensionReferences è disponibile solo se si usa la versione 2013-11-01 o una versione successiva.

VMImageName

Facoltativo. Specifica il nome dell'immagine di macchina virtuale da usare per creare la macchina virtuale. Se si usa questo elemento, non viene usato l'elemento ConfigurationSets. Per altre informazioni, vedere Acquisire l'immagine di macchina virtuale.

L'elemento VMImageName è disponibile solo se si usa la versione 01.02.14 o una versione successiva.

MediaLocation

Obbligatorio se la macchina virtuale viene creata a partire da un'immagine di macchina virtuale pubblicata. Indica il percorso del file VHD creato quando VMImageName specifica un'immagine di macchina virtuale pubblicata.

L'elemento MediaLocation è disponibile solo se si usa la versione 01.05.14 o una versione successiva.

AvailabilitySetName

Facoltativo. Specifica il nome di una raccolta di macchine virtuali. Le macchine virtuali specificate nello stesso set di disponibilità vengono allocate a nodi diversi per ottimizzare la disponibilità.

DataVirtualHardDisks

Facoltativo. Contiene i parametri usati per aggiungere un disco dati a una macchina virtuale. Se si crea una macchina virtuale usando un'immagine di macchina virtuale, questo elemento non viene usato. Per altre informazioni sui dischi dati, vedere Gestisci dischi e immagini.

OSVirtualHardDisk

Facoltativo. Contiene i parametri usati per creare il disco del sistema operativo per una macchina virtuale. Se si crea una macchina virtuale usando un'immagine di macchina virtuale, questo elemento non viene usato.

RoleSize

Facoltativo. Specifica la dimensione della macchina virtuale. La dimensione predefinita è Piccola. Per altre informazioni sulle dimensioni delle macchine virtuali, vedere la pagina relativa alle dimensioni delle macchine virtuali e dei servizi cloud per Azure.

ProvisionGuestAgent

Facoltativo. Indica se nella macchina virtuale è installato l'agente VM. Per eseguire un'estensione di risorsa in una macchina virtuale, questo servizio deve essere installato.

I valori possibili sono:

  • true

  • false

VMImageInput

Facoltativo. Specifica nuove dimensioni per i dischi in un'immagine di macchina virtuale.

L'elemento VMImageInput è disponibile solo se si usa la versione 01.10.14 o una versione successiva.

Contiene una raccolta di set di configurazione che specificano le impostazioni di configurazione dell'applicazione e di sistema.

 

Nome elemento Descrizione

ConfigurationSet

Obbligatorio. Specifica gli elementi di configurazione della macchina virtuale. L'attributo type è necessario per evitare che la password dell'amministratore venga scritta nel file di cronologia dell'operazione.

ConfigurationSetType

Obbligatorio. Per creare una macchina virtuale, è necessario specificare uno dei set di configurazione seguenti:

  • WindowsProvisioningConfiguration

  • LinuxProvisioningConfiguration

Facoltativo. È possibile specificare facoltativamente un set di NetworkConfiguration contenente i metadati obbligatori per creare la configurazione della rete virtuale per una macchina virtuale.

NomeComputer

Facoltativo in WindowsProvisioningConfiguration. Specifica il nome computer della macchina virtuale. Se non si specifica un nome computer, ne viene assegnato uno che è una combinazione del nome della distribuzione, del nome del ruolo e del numero di identificazione. I nomi computer devono essere costituiti da un numero di caratteri compreso tra 1 e 15.

AdminPassword

Facoltativo in WindowsProvisioningConfiguration. Specifica la password da usare per un account amministratore nella macchina virtuale che deve essere creata. Se viene usata un'immagine per creare una macchina virtuale, sarà necessario specificare un nome di account amministratore da creare nella macchina usando l'elemento AdminUsername. Usare l'elemento AdminPassword per specificare la password dell'account amministratore che deve essere creato. Se invece viene usato un disco specializzato esistente per creare una macchina virtuale, questo elemento non viene usato poiché l'account dovrebbe essere già presente nel disco.

EnableAutomaticUpdates

Facoltativo in WindowsProvisioningConfiguration. Specifica se gli aggiornamenti automatici sono abilitati per la macchina virtuale. Gli aggiornamenti vengono eseguiti a un'ora casuale tra le 3.00 e le 5.00.

I valori possibili sono:

  • true

  • false

Il valore predefinito è true.

TimeZone

Facoltativo in WindowsProvisioningConfiguration. Specifica il fuso orario della macchina virtuale.

Per un elenco completo delle voci di fuso orario supportate, è possibile:

  • Fare riferimento ai valori elencati nella voce del Registro di sistema HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones.

  • È possibile usare lo strumento da riga di comando tzutil per visualizzare l'orario valido.

DomainJoin

Facoltativo in WindowsProvisioningConfiguration. Contiene le proprietà mediante le quali viene definito un dominio a cui verrà aggiunta la macchina virtuale.

StoredCertificateSettings

Facoltativo in WindowsProvisioningConfiguration. Contiene un elenco dei certificati di servizio con cui effettuare il provisioning della nuova macchina virtuale.

WinRM

Facoltativo in WindowsProvisioningConfiguration. Contiene le impostazioni di configurazione per il servizio Gestione remota Windows nella macchina virtuale. In questo modo viene abilitato Windows PowerShell.

L'elemento WinRM è supportato solo nella versione 2013-03-01 o successiva.

AdminUsername

Facoltativo in WindowsProvisioningConfiguration. Specifica il nome dell'account amministratore che viene creato per accedere alla macchina virtuale. Se viene usata un'immagine per creare una macchina virtuale, sarà necessario specificare un nome di account amministratore da creare usando questo elemento. Usare l'elemento AdminPassword per specificare la password dell'account amministratore che deve essere creato. Se invece viene usato un disco specializzato esistente per creare una macchina virtuale, questo elemento non viene usato poiché l'account dovrebbe essere già presente nel disco.

CustomData

Facoltativo in WindowsProvisioningConfiguration. Specifica una stringa con codifica in Base 64 di dati personalizzati. La stringa con codifica in Base 64 viene decodificata in una matrice binaria salvata come file nella macchina virtuale. La lunghezza massima della matrice binaria è 65535 byte. Il file viene salvato in %SYSTEMDRIVE%\AzureData\CustomData.bin. Se esiste già, il file verrà sovrascritto. La sicurezza nella directory è impostata su System:Full Control e Administrators:Full Control.

L'elemento CustomData è disponibile solo se si usa la versione 01.10.13 o una versione successiva.

AdditionalUnattendContent

Facoltativo. Specifica informazioni aggiuntive in formato XML con codifica Base 64 che possono essere incluse nel file Unattend.xml usato da Installazione di Windows. Per altre informazioni, vedere Panoramica dei file di risposte.

L'elemento AdditionalUnattendContent è disponibile solo se si usa la versione 01.04.14 o una versione successiva.

HostName

Obbligatorio in LinuxProvisioningConfiguration. Specifica il nome host della macchina virtuale. I nomi host devono essere costituiti da un numero di caratteri compreso tra 1 e 64.

UserName

Obbligatorio in LinuxProvisioningConfiguration. Specifica il nome di un account utente da creare nel gruppo sudoer della macchina virtuale. I nomi degli account utente devono avere una lunghezza compresa tra 1 e 32 caratteri.

UserPassword

Obbligatorio in LinuxProvisioningConfiguration. Specifica la password per l'account utente. Le password devono avere una lunghezza compresa tra 6 e 72 caratteri.

DisableSshPasswordAuthentication

Facoltativo in LinuxProvisioningConfiguration. Specifica se l'autenticazione con password SSH è disabilitata. Per impostazione predefinita, questo valore è impostato su true.

I valori possibili sono:

  • true

  • false

Il valore predefinito è true.

SSH

Facoltativo in LinuxProvisioningConfiguration. Specifica le coppie di chiavi e le chiavi pubbliche SSH da usare con la macchina virtuale.

CustomData

Facoltativo in LinuxProvisioningConfiguration. Specifica una stringa con codifica in Base 64 di dati personalizzati. La stringa codificata in base 64 si trova nel file ovf-env.xml nell'immagine ISO della macchina virtuale. Il file viene copiato in /var/lib/waagent/ovf-env.xml dall'agente Linux di Azure. L'agente inserirà i dati con codifica Base 64 in /var/lib/waagent/CustomData durante il provisioning. La lunghezza massima della matrice binaria è 65535 byte.

L'elemento CustomData è disponibile solo se si usa la versione 01.10.13 o una versione successiva.

InputEndpoints

Facoltativo in NetworkConfiguration. Contiene una raccolta di endpoint esterni per la macchina virtuale.

SubnetNames

Facoltativo in NetworkConfiguration. Contiene un elenco di subnet a cui apparterrà la macchina virtuale.

StaticVirtualNetworkIPAddress

Facoltativo. Specifica l'indirizzo IP interno della macchina virtuale in una rete virtuale. Se si specifica questo elemento, è necessario specificare anche l'elemento SubnetNames con una sola subnet definita. L'indirizzo IP specificato in questo elemento deve appartenere alla subnet definita in SubnetNames e non deve essere tra i primi quattro indirizzi IP né l'ultimo indirizzo IP nella subnet. La distribuzione di ruoli Web o di lavoro in una subnet con macchine virtuali con StaticVirtualNetworkIPAddress definito non è supportata.

L'elemento StaticVirtualNetworkIPAddress è disponibile solo se si usa la versione 2013-11-01 o una versione successiva.

NetworkSecurityGroup

Facoltativo. Rappresenta il nome del gruppo di sicurezza di rete che verrà associato alla macchina virtuale. Il gruppo di sicurezza di rete deve esistere nel contesto della sottoscrizione e deve essere stato creato nella stessa area in cui verrà distribuita la macchina virtuale.

L'elemento NetworkSecurityGroup è disponibile solo se si usa la versione 01.10.14 o una versione successiva.

PublicIPs

Facoltativo. Contiene un indirizzo IP pubblico da usare in aggiunta all'indirizzo IP virtuale predefinito della macchina virtuale.

L'elemento PublicIPs è disponibile solo se si usa la versione 01.05.14 o una versione successiva.

NetworkInterfaces

Facoltativo. Un set di interfacce di rete secondarie. Il numero delle interfacce di rete secondarie consentito dipende dalle dimensioni della macchina virtuale. L'elemento NetworkInterfaces è disponibile solo se si usa la versione 2014-08-01 o successiva.

Contiene le proprietà mediante le quali viene definito un dominio a cui verrà aggiunta la macchina virtuale.

 

Nome elemento Descrizione

Credenziali

Facoltativo. Specifica le credenziali da usare per aggiungere la macchina virtuale al dominio.

JoinDomain

Facoltativo. Specifica il dominio a cui aggiungere la macchina virtuale.

MachineObjectOU

Facoltativo. Specifica il nome distinto X 500 LDAP (Lightweight Directory Access Protocol) dell'unità organizzativa in cui viene creato l'account computer. Questo account è incluso in Active Directory in un controller di dominio nel dominio a cui viene aggiunto il computer.

Esempio: OU=MyOu, OU=MyParentOu, DC=example.com, DC=MyCompany, DC=com

Specifica le credenziali da usare per aggiungere la macchina virtuale al dominio.

 

Nome elemento Descrizione

Domain

Facoltativo. Specifica il nome del dominio usato per autenticare un account Il valore è un dominio DNS completo. Se il nome di dominio non viene specificato, per Username è necessario specificare il formato del nome dell'entità utente (UPN) (utente@dominio-DNS-completo) o il formato dominio-DNS-completo/nomeutente.

Esempio: example.com

Username

Obbligatorio. Specifica un nome utente nel dominio che è possibile usare per l'aggiunta al dominio.

Password

Obbligatorio. Specifica la password da usare per l'aggiunta al dominio.

Contiene un elenco dei certificati di servizio con cui effettuare il provisioning della nuova macchina virtuale. Le impostazioni dei certificati archiviati fanno riferimento ai certificati già esistenti nel servizio cloud. Prima di configurare i certificati archiviati per la macchina virtuale, è necessario chiamare l'operazione Aggiungere un certificato di servizio o aggiungere il certificato tramite il portale di gestione.

 

Nome elemento Descrizione

CertificateSetting

Obbligatorio. Specifica i parametri del certificato.

StoreLocation

Obbligatorio. Specifica il percorso dell'archivio certificati nella macchina virtuale.

L'unico valore supportato è LocalMachine.

StoreName

Obbligatorio. Specifica il nome dell'archivio certificati da cui recuperare il certificato.

Esempio: My

Identificazione personale

Obbligatorio. Specifica l'identificazione personale del certificato. Nell'identificazione personale deve essere specificato un certificato di servizio esistente.

Contiene le impostazioni di configurazione per il servizio Gestione remota Windows nella macchina virtuale.

 

Nome elemento Descrizione

Listener

Obbligatorio. Contiene una raccolta di informazioni per abilitare Windows PowerShell remoto.

Listener

Obbligatorio. Specifica le informazioni sul certificato e sul protocollo per il listener.

Protocollo

Specifica il protocollo di listener.

I valori possibili sono:

  • HTTP

  • Https

Per il valore viene fatta distinzione tra maiuscole e minuscole.

CertificateThumbprint

Facoltativo. Specifica l'identificazione personale del certificato per la connessione sicura. Se questo valore non è specificato, per la macchina virtuale viene generato e usato un certificato autofirmato.

Specifica informazioni aggiuntive in formato XML con codifica Base 64 che possono essere incluse nel file Unattend.xml usato da Installazione di Windows.

 

Nome elemento Descrizione

PassName

Obbligatorio. Specifica il nome del passaggio a cui si applica il contenuto. L'unico valore consentito è oobeSystem.

ComponentName

Obbligatorio. Specifica il nome del componente da configurare con il contenuto aggiunto. L'unico valore consentito è Microsoft-Windows-Shell-Setup.

SettingName

Obbligatorio. Specifica il nome dell'impostazione a cui si applica il contenuto.

I valori possibili sono:

  • FirstLogonCommands

  • AutoLogon

Contenuto

Obbligatorio. Specifica il contenuto in formato XML con codifica Base 64 che viene aggiunto al file Unattend.xml per il percorso e il componente indicati. Il file XML deve avere dimensioni inferiori a 4 KB e deve includere l'elemento radice relativo all'impostazione o alla funzionalità in fase di inserimento.

Specifica le coppie di chiavi e le chiavi pubbliche SSH da usare con la macchina virtuale.

 

Nome elemento Descrizione

PublicKeys

Facoltativo. Specifica la raccolta di chiavi pubbliche SSH.

PublicKey

Obbligatorio. Specifica la chiave pubblica.

FingerPrint

Obbligatorio. Specifica l'impronta digitale SHA1 di un certificato X509 associato al servizio cloud e include la chiave pubblica SSH.

Percorso

Obbligatorio. Specifica il percorso completo di un file, nella macchina virtuale, in cui è archiviata la chiave pubblica SSH. Se il file esiste già, la chiave specificata viene aggiunta al file.

Esempio: /home/user/.ssh/authorized_keys

KeyPairs

Obbligatorio. Specifica una raccolta di coppie di chiavi SSH.

KeyPair

Obbligatorio. Specifica una coppia di chiavi SSH da installare nella macchina virtuale.

FingerPrint

Obbligatorio. Specifica l'impronta digitale SHA1 di un certificato X509 associato al servizio cloud e include la coppia di chiavi SSH.

Percorso

Obbligatorio. Specifica il percorso completo di un file, nella macchina virtuale, in cui è archiviata la chiave privata SSH. Quando vengono scritte più chiavi, il file viene sovrascritto. La chiave pubblica SSH viene archiviata nella stessa directory e ha lo stesso nome del file della chiave privata con suffisso pub.

Esempio: /home/user/.ssh/id_rsa

Contiene una raccolta di endpoint esterni per la macchina virtuale.

 

Nome elemento Descrizione

InputEndpoint

Obbligatorio. Specifica le proprietà mediante le quali viene definito un endpoint esterno per la macchina virtuale.

LoadBalancedEndpointSetName

Facoltativo. Specifica il nome di un set di endpoint con carico bilanciato. Se specificato per un endpoint, questo elemento viene aggiunto al set

Non impostare questa proprietà se si aggiunge l'endpoint per la connessione alla macchina virtuale tramite il desktop remoto.

noteNota
Il nome dell'endpoint deve essere univoco nell'ambito della macchina virtuale.

LocalPort

Obbligatorio. Specifica la porta interna su cui la macchina virtuale è in ascolto.

Nome

Obbligatorio. Specifica il nome dell'endpoint esterno.

Porta

Obbligatorio. Specifica la porta esterna da usare per l'endpoint.

LoadBalancerProbe

Facoltativo. Contiene le proprietà mediante le quali vengono definite le impostazioni dell'endpoint usate dal dispositivo di bilanciamento del carico per monitorare la disponibilità della macchina virtuale prima di inoltrarvi il traffico.

Protocollo

Obbligatorio. Specifica il protocollo di trasporto per l'endpoint.

I valori possibili sono:

  • TCP

  • UDP

Il valore predefinito è false.

EnableDirectServerReturn

Facoltativo. Specifica se Direct Server Return viene usato dall'endpoint. L'elemento EnableDirectServerReturn non è supportato per gli endpoint RDP, SSH o WinRM né quando la porta pubblica e quella locale di un endpoint sono diverse. È consigliabile usare questo elemento solo quando si installano le macchine virtuali per SQL Server e i gruppi di disponibilità AlwaysOn. Per altre informazioni, vedere Disponibilità elevata e ripristino di emergenza di SQL Server in Macchine virtuali di Azure.

I valori possibili sono:

  • true

  • false

Il valore predefinito è false.

EndpointACL

Facoltativo. Contiene una raccolta di regole mediante le quali viene controllato il traffico di rete all'endpoint.

L'elemento EndpointACL è disponibile solo se si usa la versione 2013-06-01 o una versione successiva.

LoadBalancerName

Facoltativo. Specifica il nome del dispositivo di bilanciamento del carico interno associato all'endpoint.

L'elemento LoadBalancerName è disponibile solo se si usa la versione 01.05.14 o una versione successiva.

IdleTimeoutInMinutes

Facoltativo. Specifica il timeout per la connessione TCP inattiva. Il valore può essere compreso tra 4 e 30 minuti. Il valore predefinito è 4 minuti. Questo valore viene usato soltanto quando il protocollo è impostato su TCP.

L'elemento IdleTimeoutInMinutes è disponibile solo se si usa la versione 01.06.14 o una versione successiva.

Contiene le proprietà mediante le quali vengono definite le impostazioni dell'endpoint usate dal dispositivo di bilanciamento del carico per monitorare la disponibilità della macchina virtuale prima di inoltrarvi il traffico.

 

Nome elemento Descrizione

Percorso

Facoltativo. Specifica il percorso relativo da verificare per determinare lo stato di disponibilità della macchina virtuale. Se il protocollo è impostato su TCP, questo valore deve essere NULL.

Esempio: path

Per eseguire il probe, verrà usato https://example.com/path.

Porta

Facoltativo. Specifica la porta da usare per verificare lo stato di disponibilità della macchina virtuale.

Protocollo

Facoltativo. Specifica il protocollo da usare per verificare lo stato di disponibilità della macchina virtuale.

I valori possibili sono:

  • HTTP

  • TCP

IntervalInSeconds

Facoltativo. Specifica l'intervallo del probe di bilanciamento del carico in secondi. Il valore minimo è 5 secondi. Il valore predefinito è 15 secondi.

TimeoutInSeconds

Facoltativo. Specifica il timeout del probe di bilanciamento del carico in secondi. Il valore minimo è 11 secondi. Il valore predefinito è 31 secondi.

Contiene una raccolta di regole mediante le quali viene controllato il traffico di rete in ingresso all'endpoint.

 

Nome elemento Descrizione

Regole

Obbligatorio. Specifica una raccolta di regole di controllo di accesso. Sono consentite fino a 50 regole.

Rule

Obbligatorio. Specifica la definizione di una regola di controllo di accesso.

Order

Obbligatorio. Specifica la priorità della regola. Il valore può essere compreso tra 0 e 65535. Il numero di ordine deve essere univoco per ciascuna regola della raccolta. Più basso è il numero di ordine, più elevata è la priorità della regola.

Azione

Obbligatorio. Specifica se il traffico che corrisponde alla regola deve essere consentito o negato.

I valori possibili sono:

  • permit

  • deny

RemoteSubnet

Obbligatorio. Specifica la subnet per la regola. La subnet deve essere nella notazione CIDR (Classless Inter-Domain Routing) IPV4 ed essere valida,

Descrizione

Facoltativo. Specifica una descrizione per la regola. La lunghezza massima della descrizione è pari a 256 caratteri.

Contiene un indirizzo IP pubblico da usare in aggiunta all'indirizzo IP virtuale predefinito della macchina virtuale.

 

Nome elemento Descrizione

PublicIP

Obbligatorio. Specifica un indirizzo IP pubblico aggiuntivo che può essere usato per comunicare con la macchina virtuale.

Nome

Obbligatorio. Specifica il nome dell'indirizzo IP pubblico.

IdleTimeoutInMinutes

Facoltativo. Specifica il timeout per la connessione TCP inattiva. Il valore può essere compreso tra 4 e 30 minuti. Il valore predefinito è 4 minuti. Questo valore viene usato soltanto quando il protocollo è impostato su TCP.

L'elemento IdleTimeoutInMinutes è disponibile solo se si usa la versione 01.06.14 o una versione successiva.

DomainNameLabel

Facoltativo. Specifica l'etichetta del nome di dominio per l'indirizzo IP pubblico.

L'elemento DomainNameLabel è disponibile solo se si usa la versione 01.03.15 o una versione successiva.

Contiene un set di interfacce di rete secondarie.

 

Nome elemento Descrizione

NetworkInterface

Obbligatorio. Specifica un'interfaccia di rete secondaria.

Nome

Obbligatorio. Specifica il nome dell'interfaccia di rete secondaria.

MacAddress

Obbligatorio. Specifica l'indirizzo MAC dell'interfaccia di rete secondaria.

IPConfigurations

Obbligatorio. Specifica un set di configurazioni di indirizzo IP per un'interfaccia di rete secondaria.

Specifica un set di configurazioni di indirizzo IP per un'interfaccia di rete secondaria.

 

Nome elemento Descrizione

IPConfiguration

Obbligatorio. Specifica una configurazione di indirizzo IP per un'interfaccia di rete secondaria.

Attualmente è supportata solo una configurazione di indirizzo IP per un'interfaccia di rete secondaria.

SubnetName

Obbligatorio. Specifica il nome della subnet della rete virtuale a cui appartiene questa configurazione di indirizzo IP.

Address

Obbligatorio. Specifica l'indirizzo IP interno configurato per un'interfaccia di rete secondaria.

Contiene un elenco di subnet a cui apparterrà la macchina virtuale.

 

Nome elemento Descrizione

SubnetName

Obbligatorio. Specifica il nome di una subnet a cui appartiene la macchina virtuale.

Contiene i parametri usati per aggiungere un disco dati a una macchina virtuale.

 

Nome elemento Descrizione

DataVirtualHardDisk

Obbligatorio. Specifica le proprietà usate per creare un disco dati.

HostCaching

Facoltativo. Specifica il comportamento di memorizzazione nella cache del disco dati per l'efficienza di lettura/scrittura. L'impostazione di questa proprietà influisce sulla coerenza del disco.

I valori possibili sono:

  • None

  • ReadOnly

  • ReadWrite

Il valore predefinito è None.

DiskLabel

Facoltativo. Se il disco che viene aggiunto è già registrato nella sottoscrizione, questo elemento viene ignorato. Se viene creato un nuovo disco, questo elemento viene usato per fornirne una descrizione. Il valore di questo elemento viene ottenuto solo a livello di codice e non viene visualizzato nel portale di gestione.

DiskName

Facoltativo. Se il disco che viene aggiunto è già registrato nella sottoscrizione, questo elemento viene usato per identificare il disco da aggiungere. Se vengono creati da Azure un nuovo disco e il VHD associato, questo elemento non viene usato e tramite Azure viene assegnato un nome univoco costituito da una combinazione di nome della distribuzione, nome del ruolo e numero di identificazione.

Il nome del disco può contenere unicamente caratteri alfanumerici, caratteri di sottolineatura, punti o trattini. La lunghezza del nome non deve superare i 256 caratteri. Il nome non deve terminare con un punto o un trattino.

Lun

Facoltativo. Specifica il numero di unità logica (LUN) per il disco dati. Se quello aggiunto è il primo disco, questo elemento è facoltativo e viene usato il valore predefinito 0. Se vengono aggiunti più dischi, questo elemento è obbligatorio. I valori LUN validi sono compresi tra 0 e 31. È possibile usare l'operazione Get Role per individuare i numeri LUN già in uso.

LogicalDiskSizeInGB

Facoltativo. Specifica le dimensioni, in GB, di un disco vuoto da collegare alla macchina virtuale. Se il disco che viene aggiunto è già registrato nella sottoscrizione, questo elemento viene ignorato. Se il disco e il VHD vengono creati da Azure quando vengono aggiunti, tramite questo elemento vengono definite le dimensioni del nuovo disco.

Il numero di dischi che si possono aggiungere a una macchina virtuale viene limitato dalla dimensione della macchina. Per altre informazioni, vedere la pagina relativa alle dimensioni delle macchine virtuali e dei servizi cloud per Azure.

Questo elemento viene usato con l'elemento MediaLink.

MediaLink

Facoltativo. Se il disco che viene aggiunto è già registrato nella sottoscrizione oppure il VHD per il disco già esiste nell'archiviazione BLOB, questo elemento viene ignorato. Se un file VHD non esiste nell'archiviazione BLOB, tramite questo elemento viene definito il percorso del nuovo VHD creato al momento dell'aggiunta del nuovo disco.

Esempio: http://example.blob.core.windows.net/disks/mydatadisk.vhd

SourceMediaLink

Facoltativo. Se il disco che viene aggiunto è già registrato nella sottoscrizione oppure il VHD per il disco non esiste nell'archiviazione BLOB, questo elemento viene ignorato. Se il file VHD esiste nell'archiviazione BLOB, tramite questo elemento viene definito il percorso del VHD e da quest'ultimo viene registrato un disco e collegato alla macchina virtuale.

Contiene i parametri usati per creare il disco del sistema operativo per una macchina virtuale.

 

Nome elemento Descrizione

HostCaching

Facoltativo. Specifica la modalità di memorizzazione nella cache del disco del sistema operativo. Questa impostazione influisce sulla coerenza e sulle prestazioni del disco.

I valori possibili sono:

  • ReadOnly

  • ReadWrite

Il valore predefinito è ReadWrite.

noteNota
La modifica di questo valore comporta il riavvio della macchina virtuale.

DiskLabel

Facoltativo. Specifica la descrizione del disco.

DiskName

Obbligatorio se per la creazione di una macchina virtuale viene usato un disco esistente. Specifica il nome di un disco nuovo o esistente. Se per un disco nuovo non viene specificato questo elemento, verrà assegnato un nome univoco costituito da una combinazione di nome della distribuzione, nome del ruolo e numero di identificazione.

Il nome del disco può contenere unicamente caratteri alfanumerici, caratteri di sottolineatura, punti o trattini. La lunghezza del nome non deve superare i 256 caratteri. Il nome non deve terminare con un punto o un trattino.

MediaLink

Obbligatorio se la macchina virtuale viene creata a partire da un'immagine della piattaforma. Specifica il percorso del file VHD creato quando viene specificata un'immagine della piattaforma da SourceImageName. Questo elemento non viene usato se la macchina virtuale viene creata a partire da un disco esistente.

Esempio: http://contoso.blob.core.windows.net/disks/mydisk.vhd

SourceImageName

Facoltativo. Specifica il nome dell'immagine da usare per la creazione della macchina virtuale. È possibile specificare un'immagine utente o un'immagine della piattaforma. Un'immagine è sempre associata a un VHD, vale a dire un file con estensione vhd archiviato come BLOB di pagine in un account di archiviazione in Azure. Se si specifica un'immagine della piattaforma, viene creato un VHD associato e sarà necessario usare l'elemento MediaLink per specificare il percorso nella risorsa di archiviazione in cui verrà posizionato il VHD.

Sistema operativo

Obbligatorio se si usa RemoteSourceImageLink. Specifica il tipo di sistema operativo installato nell'immagine.

I valori possibili sono:

  • Windows

  • Linux

RemoteSourceImageLink

Facoltativo. Specifica l'URI della posizione in cui viene archiviata un'immagine del sistema operativo usata per creare la macchina virtuale. Un'immagine è sempre associata a un VHD, vale a dire un file con estensione vhd archiviato come BLOB di pagine in un account di archiviazione in Microsoft Azure. Se si specifica il percorso di un'immagine con questo elemento, viene creato un VHD associato e sarà necessario usare l'elemento MediaLink per indicare la posizione della risorsa di archiviazione in cui verrà inserito il VHD. Se si usa questo elemento, SourceImageName non viene usato.

L'elemento RemoteSourceImageLink è disponibile solo se si usa la versione 01.05.14 o una versione successiva.

ResizedSizeInGB

Quando un'immagine del sistema operativo o un elemento RemoteSourceImage viene usato per creare un elemento OSVirtualHardDisk, questo parametro può essere usato per ridimensionare il nuovo elemento OSVirtualHardDisk in base a una dimensione maggiore. ResizedSizeInGB deve essere maggiore dell'elemento LogicalSizeInGB dell'immagine del sistema operativo sottostante. L'elemento ResizedSizeInGB è disponibile solo se si usa la versione 01.10.14 o una versione successiva.

Specifica nuove dimensioni per i dischi in un'immagine di macchina virtuale.

 

Nome elemento Descrizione

OSDiskConfiguration

Facoltativo. Specifica la configurazione del disco di sistema operativo dell'immagine di macchina virtuale.

L'elemento OSDiskConfiguration è disponibile solo se si usa la versione 01.10.14 o una versione successiva.

ResizedSizeInGB

Obbligatorio. Specifica nuove dimensioni (maggiori) del disco di sistema operativo dell'immagine di macchine virtuale.

L'elemento ResizedSizeInGB è disponibile solo se si usa la versione 01.10.14 o una versione successiva.

DataDiskConfigurations

Facoltativo. Specifica la configurazione dei dischi dati dell'immagine di macchina virtuale.

L'elemento DataDiskConfigurations è disponibile solo se si usa la versione 01.10.14 o una versione successiva.

Specifica la configurazione dei dischi dati dell'immagine di macchina virtuale.

 

Nome elemento Descrizione

DataDiskConfiguration

Obbligatorio. Specifica la configurazione del disco dati.

L'elemento DataDiskConfiguration è disponibile solo se si usa la versione 01.10.14 o una versione successiva.

Nome

Obbligatorio. Specifica il nome del disco dati.

L'elemento Name è disponibile solo se si usa la versione 01.10.14 o una versione successiva.

Esempio: MyVMImage1-datadisk-2-2014-02-21

ResizedSizeInGB

Obbligatorio. Specifica le nuove dimensioni (maggiori) del disco dati.

L'elemento ResizedSizeInGB è disponibile solo se si usa la versione 01.10.14 o una versione successiva.

Contiene una raccolta di estensioni di risorsa da installare nella macchina virtuale. Un'estensione di risorsa è un componente software installato nella macchina virtuale. Per installare le estensioni di risorsa, deve essere installato l'agente VM nella macchina virtuale. Per altre informazioni, vedere Gestire le estensioni.

 

Nome elemento Descrizione

ResourceExtensionReference

Obbligatorio. Specifica le proprietà di un'estensione di risorsa che devono essere installate nella macchina virtuale.

ReferenceName

Obbligatorio. Specifica il nome di riferimento dell'estensione di risorsa.

Publisher

Obbligatorio. Specifica il nome dell'editore che ha creato l'estensione di risorsa. È possibile usare Elencare le estensioni delle risorse per trovare il nome dell'editore di un'estensione di risorsa.

Nome

Obbligatorio. Specifica il nome dell'estensione di risorsa. È possibile usare Elencare le estensioni delle risorse per trovare i nomi di estensioni di risorsa disponibili.

Version

Obbligatorio. Specifica la versione dell'estensione di risorsa. È possibile impostare questo valore su * per usare l'ultima versione dell'estensione. Se l'estensione è stata aggiunta o aggiornata recentemente, è necessario verificare che il valore di ReplicationCompleted sia impostato su true per poter usare la versione dell'estensione. Per determinare lo stato della replica e le versioni disponibili dell'estensione, è possibile usare Elencare le versioni dell'estensione di una risorsa.

ResourceExtensionParameterValues

Facoltativo. Contiene una raccolta di parametri passati all'estensione di risorsa quando viene installata.

State

Facoltativo. Specifica lo stato dell'estensione di risorsa. Quando viene creata una macchina virtuale, l'unico stato che è possibile specificare è enable, ovvero il valore predefinito se non viene usato questo elemento. Per altre informazioni sulla disabilitazione o la rimozione di un'estensione, vedere Aggiornare il ruolo.

Certificati

Facoltativo. Contiene una raccolta di certificati installati nella machina virtuale e usati dall'estensione. Per poter essere inclusi in questa richiesta, i certificati devono essere aggiunti al servizio cloud. Per altre informazioni, vedere Aggiungere un certificato di servizio.

L'elemento Certificates è disponibile solo se si usa la versione 01.06.14 o una versione successiva.

Contiene una raccolta di certificati installati nella machina virtuale e usati dall'estensione.

 

Nome elemento Descrizione

Identificazione personale

Obbligatorio. Specifica l'identificazione personale del certificato che deve essere usato dall'estensione.

ThumbprintAlgorithm

Obbligatorio. Specifica l'algoritmo di identificazione personale. Questo valore è sempre sha1.

Contiene una raccolta di parametri passati all'estensione di risorsa quando viene installata.

 

Nome elemento Descrizione

ResourceExtensionParameterValue

Obbligatorio. Specifica la chiave, il valore e il tipo del parametro.

Chiave

Obbligatorio. Specifica la chiave del parametro.

Valore

Obbligatorio. Specifica il valore con codifica Base 64 del parametro. Se la configurazione dell'estensione è in formato XML, questo valore viene convalidato usando lo schema pubblico o privato. Lo schema usato dipende dal valore di Type.

Se invece la configurazione dell'estensione è in formato JSON, questo valore deve includere un oggetto JSON valido. Non è possibile usare gli schemi pubblici o privati per convalidare l'oggetto. Per usare un oggetto JSON, il numero di versione deve essere 2014-04-01 o successivo.

Tipo

Obbligatorio. Specifica il tipo dell'estensione di risorsa.

I valori possibili sono:

  • Public

  • Private

Se questo valore è impostato su Private, il parametro non verrà restituito dall'operazione Get Deployment. È possibile specificare solo un parametro pubblico e uno privato per un massimo di due parametri.

Contiene un elenco di server DNS da associare alla macchina virtuale.

 

Nome elemento Descrizione

DnsServers

Obbligatorio. Contiene i parametri che specificano i server DNS da usare per la macchina virtuale.

DnsServer

Obbligatorio. Contiene gli elementi Name e Address del server DNS.

Nome

Obbligatorio. Specifica il nome del server DNS.

Address

Obbligatorio. Specifica l'indirizzo IP del server DNS.

Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni per la risposta e il corpo di una risposta.

Un'operazione completata correttamente restituisce il codice di stato 202 (Accettato). Per informazioni sui codici di stato, vedere Codici di stato e di errore relativi alla gestione dei servizi.

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

 

Intestazione della risposta Descrizione

x-ms-request-id

Valore che identifica in modo univoco una richiesta eseguita nel servizio di gestione.

Per aggiungere macchine virtuali a una distribuzione è inoltre possibile usare le risorse seguenti:

I dischi con provisioning possono essere aggiunti solo a dimensioni di macchina virtuale con provisioning.

Mostra:
© 2015 Microsoft