AzureFileCopy@2 - Attività copia file di Azure v2

Copiare file in Archiviazione BLOB di Azure o macchine virtuali.

Sintassi

# Azure file copy v2
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
    Destination: # 'AzureBlob' | 'AzureVMs'. Required. Destination Type. 
    #classicStorage: # string. Alias: StorageAccount. Required when ConnectedServiceNameSelector = ConnectedServiceName. Classic Storage Account. 
    storage: # string. Alias: StorageAccountRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. RM Storage Account. 
    #ContainerName: # string. Required when Destination = AzureBlob. Container Name. 
    #BlobPrefix: # string. Optional. Use when Destination = AzureBlob. Blob Prefix. 
    #cloudService: # string. Alias: EnvironmentName. Required when ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs. Cloud Service. 
    #resourceGroup: # string. Alias: EnvironmentNameRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM && 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 ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Enable Copy Prerequisites. Default: false.
    #CopyFilesInParallel: true # boolean. Optional. Use when Destination = AzureVMs. Copy in Parallel. Default: true.
    #CleanTargetBeforeCopy: false # boolean. Optional. Use when Destination = AzureVMs. Clean Target. Default: false.
    #skipCACheck: true # boolean. Optional. Use when Destination = AzureVMs. Test Certificate. Default: true.
  # Output
    #outputStorageUri: # string. Storage Container URI. 
    #outputStorageContainerSasToken: # string. Storage Container SAS Token.
# Azure File Copy v2
# Copy files to Azure blob or VM(s).
- task: AzureFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
    Destination: # 'AzureBlob' | 'AzureVMs'. Required. Destination Type. 
    #classicStorage: # string. Alias: StorageAccount. Required when ConnectedServiceNameSelector = ConnectedServiceName. Classic Storage Account. 
    storage: # string. Alias: StorageAccountRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. RM Storage Account. 
    #ContainerName: # string. Required when Destination = AzureBlob. Container Name. 
    #BlobPrefix: # string. Optional. Use when Destination = AzureBlob. Blob Prefix. 
    #cloudService: # string. Alias: EnvironmentName. Required when ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs. Cloud Service. 
    #resourceGroup: # string. Alias: EnvironmentNameRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM && 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 ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Enable Copy Prerequisites. Default: false.
    #CopyFilesInParallel: true # boolean. Optional. Use when Destination = AzureVMs. Copy in Parallel. Default: true.
    #CleanTargetBeforeCopy: false # boolean. Optional. Use when Destination = AzureVMs. Clean Target. Default: false.
    #skipCACheck: true # boolean. Optional. Use when Destination = AzureVMs. Test Certificate. Default: true.
  # Output
    #outputStorageUri: # string. Storage Container URI. 
    #outputStorageContainerSasToken: # string. Storage Container SAS Token.

Input

SourcePath - Fonte
string. Obbligatorio.

Specificare il percorso assoluto della cartella di origine, del file nel computer locale o di una condivisione UNC. Il valore o l'espressione specificati devono restituire un singolo nome di cartella o un nome file.


azureConnectionType - Tipo di connessione di Azure
Alias di input: ConnectedServiceNameSelector. string. Valori consentiti: ConnectedServiceName (Azure classico), ConnectedServiceNameARM (Resource Manager di Azure). Valore predefinito: ConnectedServiceNameARM.

Specificare il tipo di connessione di Azure.


azureClassicSubscription - Sottoscrizione classica di Azure
Alias di input: ConnectedServiceName. string. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceName.

Specificare la sottoscrizione classica di Azure di destinazione.


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

Specificare la sottoscrizione di Azure Resource Manager di destinazione.


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

Specificare il tipo di destinazione da usare per copiare i file.


classicStorage - Account di archiviazione classico
Alias di input: StorageAccount. string. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceName.

Specificare un account di archiviazione classico preesistente. Si tratta dell'account di archiviazione usato come intermediario per la copia di file in macchine virtuali di Azure.


storage - Account di archiviazione RM
Alias di input: StorageAccountRM. string. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceNameARM.

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


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

Specificare il 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 vd1/vd2BLOB .


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

Specificare un prefisso che può essere usato per filtrare i file.

Esempio: è possibile aggiungere un numero di compilazione per filtrare i file da tutti i BLOB con lo stesso numero di compilazione.

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


cloudService - Servizio cloud
Alias di input: EnvironmentName. string. Obbligatorio quando ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs.

Specificare il nome del servizio cloud di destinazione.


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

Specificare il nome del gruppo di risorse di destinazione.


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

Specificare il nome host o il 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 host di macchine virtuali di Azure, ffwebad esempio , ffdbo tag, Role:DBad esempio , Web, OS:Win8.1.

Nota: i delimitatori validi per i tag includono ,(virgola), :(colon) e ;(semicolon. Quando si specificano più tag, l'attività verrà eseguita in tutte le macchine virtuali che contengono i tag specificati. Per impostazione predefinita, l'attività viene eseguita in tutte le macchine virtuali.


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

Specificare il nome utente dell'account amministratore della macchina virtuale di Azure.


vmsAdminPassword - Password
string. Obbligatorio quando Destination = AzureVMs.

Specificare la password per l'account amministratore della macchina virtuale di Azure.

L'input valido include variabili definite nelle pipeline di compilazione o versione, $(passwordVariable)ad esempio . Per proteggere una password, contrassegnarla come secret.


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

Specificare il percorso locale nelle macchine virtuali di destinazione.

L'input valido include variabili di ambiente come $env:windir\BudgetIT\Web.


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

Specificare argomenti aggiuntivi a AzCopy.exe che possono essere applicati durante il caricamento in BLOB, /NC:10ad esempio .

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

  • /Y
  • /SetContentType
  • /Z
  • /V
  • /S - Aggiunta quando il nome del contenitore non $rootè .
  • /BlobType:page - Aggiunto quando l'account di archiviazione specificato è un account Premium.
  • /Pattern - Aggiunto quando il percorso di origine è un file. Incluso con qualsiasi altro argomento facoltativo specificato.

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

Specificare argomenti aggiuntivi a AzCopy.exe che possono essere applicati durante il download di macchine virtuali, /NC:10ad esempio .

Se non vengono specificati argomenti facoltativi, i seguenti vengono aggiunti per impostazione predefinita.

  • /Y
  • /S
  • /Z
  • /V

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

Se abilitato, usa un certificato autofirmato per configurare un listener di Gestione remota Windows (WinRM) sulla porta 5986 anziché sul protocollo HTTPS. Obbligatorio per eseguire operazioni di copia nelle macchine virtuali di Azure. Se le macchine virtuali di destinazione usano un servizio di bilanciamento del carico, configurare le regole NAT in ingresso per la porta di destinazione (5986). Si applica solo per le macchine virtuali ARM.


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

Accettare l'impostazione predefinita copia i file in parallelo alle macchine virtuali di destinazione.


CleanTargetBeforeCopy - Destinazione pulita
boolean. facoltativo. Usare quando Destination = AzureVMs. Valore predefinito: false.

Impostando questo valore per true pulire la cartella di destinazione prima di eseguire l'azione di copia.


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

Il valore predefinito non convalida che il certificato del server sia stato firmato da una CA attendibile prima di connettersi tramite HTTPS.


outputStorageUri - URI contenitore di archiviazione
string.

Specificare il nome della variabile utilizzata per l'URI del contenitore di archiviazione in cui sono stati copiati i file. Valido solo quando la destinazione selezionata è un BLOB di Azure.


outputStorageContainerSasToken - Token sas del contenitore di archiviazione
string.

Specificare il nome della variabile usata per il token sas del contenitore di archiviazione che accede ai file copiati. Valido solo quando la destinazione selezionata è un BLOB di Azure.


Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni

Novità della versione 2.0: Uso della versione più recente di AzCopy.

Requisiti

Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Esecuzione in Agente, DeploymentGroup
Richieste Gli agenti self-hosted devono avere funzionalità che corrispondono alle richieste seguenti per l'esecuzione di processi che usano questa attività: azureps
Capabilities Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi Qualsiasi
Variabili impostabili Qualsiasi
Versione agente 1.103.0 o versione successiva
Categoria attività Distribuire