AzureFileCopy@6 - Attività copia file di Azure v6

Copiare i file in Archiviazione BLOB di Azure o macchine virtuali.

Questa versione dell'attività supporta la federazione delle identità del carico di lavoro e usa il controllo degli accessi in base al ruolo di Azure per accedere ad Archiviazione di Azure. In seguito all'uso del controllo degli accessi in base al ruolo di Azure, i token di firma di accesso condiviso non vengono più usati. Per altre informazioni, vedere la sezione Osservazioni .

# Azure file copy v6
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@6
  inputs:
    SourcePath: # string. Required. Source. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required. Azure Subscription. 
    Destination: # 'AzureBlob' | 'AzureVMs'. Required. Destination Type. 
    storage: # string. Alias: StorageAccountRM. Required. RM Storage Account. 
    #ContainerName: # string. Required when Destination = AzureBlob. Container Name. 
    #BlobPrefix: # string. Optional. Use when Destination = AzureBlob. Blob Prefix. 
    #resourceGroup: # string. Alias: EnvironmentNameRM. Required when Destination = AzureVMs. Resource Group. 
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Optional. Use when Destination = AzureVMs. Select Machines By. Default: machineNames.
    #MachineNames: # string. Optional. Use when Destination = AzureVMs. Filter Criteria. 
    #vmsAdminUserName: # string. Required when Destination = AzureVMs. Admin Login. 
    #vmsAdminPassword: # string. Required when Destination = AzureVMs. Password. 
    #TargetPath: # string. Required when Destination = AzureVMs. Destination Folder. 
    #AdditionalArgumentsForBlobCopy: # string. Optional Arguments (for uploading files to blob). 
    #AdditionalArgumentsForVMCopy: # string. Optional. Use when Destination = AzureVMs. Optional Arguments (for downloading files to VM). 
    #enableCopyPrerequisites: false # boolean. Optional. Use when Destination = AzureVMs. Enable Copy Prerequisites. Default: false.
    #CopyFilesInParallel: true # boolean. Optional. Use when Destination = AzureVMs. Copy in Parallel. Default: true.
    #CleanTargetBeforeCopy: false # boolean. Clean Target. Default: false.
    #skipCACheck: true # boolean. Optional. Use when Destination = AzureVMs. Test Certificate. Default: true.

SourcePath - Fonte
string. Obbligatorio.

Percorso dei file di origine. I valori supportati includono pipeline YAML e versione classica supportano variabili di sistema predefinite come Build.Repository.LocalPath.

Le variabili di versione sono supportate solo nelle versioni classiche. Il simbolo jolly (*) è supportato ovunque nel percorso del file o nel nome del file.

L'espressione deve restituire una singola cartella o un file.

azureSubscription - Sottoscrizione di Azure
Alias di input: ConnectedServiceNameARM. string. Obbligatorio.

Specificare il nome di una connessione al servizio di azure Resource Manager configurata per la sottoscrizione in cui si trova il servizio di Azure, la macchina virtuale o l'account di archiviazione di destinazione. Per altri dettagli, vedere Panoramica di Azure Resource Manager.

Destination - Tipo di destinazione
string. Obbligatorio. Valori consentiti: AzureBlob (BLOB di Azure), AzureVMs (macchine virtuali di Azure).

Specificare il tipo di destinazione.

storage - Account di archiviazione RM
Alias di input: StorageAccountRM. string. Obbligatorio.

Specificare un account di archiviazione ARM preesistente. Si tratta dell'account di archiviazione usato come intermediario per copiare i file in macchine virtuali di Azure.

ContainerName - Nome contenitore
string. Obbligatorio quando Destination = AzureBlob.

Nome del contenitore in cui vengono copiati i file. Se il contenitore specificato non esiste nell'account di archiviazione, verrà creato.

Per creare una directory virtuale all'interno del contenitore, usare l'input del prefisso BLOB. Ad esempio, per il percorso https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/di destinazione , specificare il nome mycontainer del contenitore e il prefisso BLOB: vd1/vd2.

BlobPrefix - Prefisso BLOB
string. facoltativo. Usare quando Destination = AzureBlob.

Specificare un prefisso per la directory virtuale di destinazione all'interno del contenitore BLOB di Azure. Questo vale quando contiene SourcePath un carattere jolly che può corrispondere a più elementi.

Esempio: è possibile aggiungere un numero di build per aggiungere un prefisso ai file da tutti i BLOB con lo stesso numero di build.

Esempio: se si specifica un prefisso myvd1BLOB , viene creata una directory virtuale all'interno del contenitore. I file vengono copiati dall'origine a https://myaccount.blob.core.windows.net/mycontainer/myvd1/.

Nel caso in cui sia SourcePath un singolo elemento senza caratteri jolly, questo prefisso BLOB funzionerà come nome del BLOB di destinazione.

resourceGroup - Gruppo di risorse
Alias di input: EnvironmentNameRM. string. Obbligatorio quando Destination = AzureVMs.

Specificare il nome del gruppo di risorse di destinazione in cui verranno copiati i file.

ResourceFilteringMethod - Selezionare Computer per
string. facoltativo. Usare quando Destination = AzureVMs. Valori consentiti: machineNames (Nomi computer), tags. Valore predefinito: machineNames.

Specificare un nome host o un tag della macchina virtuale che identifica un subset di macchine virtuali in un gruppo di risorse. I tag sono supportati solo per le risorse create tramite il Resource Manager di Azure.

MachineNames - Criteri di filtro
string. facoltativo. Usare quando Destination = AzureVMs.

Specificare un elenco di nomi di vm o nomi di tag che identificano le macchine virtuali di destinazione dell'attività. I criteri di filtro validi includono:

• Nome di un gruppo di risorse di Azure.
• Variabile di output di un'attività precedente.
• Elenco delimitato da virgole di nomi di tag o nomi di vm.
• Formattare i nomi delle macchine virtuali usando un elenco delimitato da virgole di FQDN o indirizzi IP.
• Formattare i nomi dei tag per un filtro come {TagName}:{Value} esempio: Role:DB;OS:Win8.1

vmsAdminUserName - account di accesso Amministrazione
string. Obbligatorio quando Destination = AzureVMs.

Specificare il nome utente di un account con autorizzazioni amministrative per tutte le macchine virtuali di destinazione.

• I formati supportati includono: username, domain\username, machine-name\usernamee .\username.
• I formati UPN inclusi username@domain.com e gli account di sistema predefiniti, ad esempio, NT Authority\System non sono supportati.

vmsAdminPassword - Password
string. Obbligatorio quando Destination = AzureVMs.

Specificare la password per il Admin Login parametro .

Per trovare la variabile, individuare il Admin Login parametro . Selezionare l'icona a forma di lucchetto per una variabile definita nella Variables scheda per proteggere il valore e inserire qui il nome della variabile.

TargetPath - Cartella di destinazione
string. Obbligatorio quando Destination = AzureVMs.

Specificare il percorso della cartella nelle macchine virtuali di Azure in cui verranno copiati i file.

Le variabili di ambiente, ad $env:windir esempio e $env:systemroot , sono supportate. Esempi: $env:windir\FabrikamFiber\Web e c:\FabrikamFiber

AdditionalArgumentsForBlobCopy - Argomenti facoltativi (per il caricamento di file in BLOB)
string.

Specificare argomenti aggiuntivi da AzCopy.exe usare durante il caricamento nel BLOB e il download nelle macchine virtuali. Per informazioni dettagliate, vedere Trasferire dati con AzCopy Command-Line Utility .

Per gli account di archiviazione Premium che supportano solo i BLOB di pagine di Azure vengono usati --blob-type=PageBlob come argomento aggiuntivo.

Gli argomenti predefiniti includono --log-level=INFO (impostazione predefinita) e --recursive (se il nome del contenitore non $rootè ).

AdditionalArgumentsForVMCopy - Argomenti facoltativi (per il download di file nella macchina virtuale)
string. facoltativo. Usare quando Destination = AzureVMs.

Fornire argomenti aggiuntivi a AzCopy.exe che verranno applicati durante il download nelle macchine virtuali, ad esempio , --check-length=true.

Se non vengono specificati argomenti facoltativi, per impostazione predefinita vengono aggiunti gli argomenti seguenti:

• --log-level=INFO
• --log-level=DEBUG (Se la pipeline è in esecuzione in modalità di debug impostata)
• --recursive

enableCopyPrerequisites - Abilitare i prerequisiti di copia
boolean. facoltativo. Usare quando Destination = AzureVMs. Valore predefinito: false.

Se abilitata, questa opzione usa un certificato autofirmato per configurare il listener di Gestione remota Windows (WinRM) sul protocollo HTTPS sulla porta 5986. Questa configurazione è necessaria per eseguire operazioni di copia nelle macchine virtuali di Azure. Applicabile solo per le macchine virtuali ARM.

• Se si accede alle macchine virtuali di destinazione tramite un servizio di bilanciamento del carico, configurare una regola NAT in ingresso per consentire l'accesso sulla porta 5986.
• Se le macchine virtuali di destinazione sono associate a un gruppo di sicurezza di rete (NSG), configurare una regola di sicurezza in ingresso per consentire l'accesso sulla porta 5986.

CopyFilesInParallel - Copiare in parallelo
boolean. facoltativo. Usare quando Destination = AzureVMs. Valore predefinito: true.

Specificare per copiare true i file in parallelo alle macchine virtuali di destinazione.

CleanTargetBeforeCopy - Destinazione pulita
boolean. Valore predefinito: false.

Specificare per pulire la cartella di destinazione prima di copiare true i file.

skipCACheck - Certificato di test
boolean. facoltativo. Usare quando Destination = AzureVMs. Valore predefinito: true.

WinRM richiede un certificato per il trasferimento HTTPS durante la copia di file dal BLOB di archiviazione intermedio nelle macchine virtuali di Azure.

Se si usa un certificato autofirmato, specificare true per impedire al processo di convalidare il certificato con una CA attendibile.

Questa attività definisce le variabili di output seguenti, che è possibile usare nei passaggi, nei processi e nelle fasi downstream.

StorageContainerUri
Uri del contenitore in cui i file sono stati copiati. Valido solo quando la destinazione selezionata è BLOB di Azure.