AzureFileCopy@2 - Tâche de copie de fichiers Azure v2

  • Article

Copiez des fichiers sur Stockage Blob Azure ou des machines virtuelles.

Notes

Cette tâche ne prend pas en charge l’authentification Azure Resource Manager avec la fédération d’identité de workflow.

Syntaxe

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

Entrées

SourcePath - Source
string. Obligatoire.

Spécifiez le chemin absolu du dossier source, du fichier sur l’ordinateur local ou d’un partage UNC. La valeur ou l’expression spécifiée doit retourner un nom de dossier unique ou un nom de fichier.


azureConnectionType - Type de connexion Azure
Alias d’entrée : ConnectedServiceNameSelector. string. Valeurs autorisées : ConnectedServiceName (Azure Classic), ConnectedServiceNameARM (Azure Resource Manager). Valeur par défaut : ConnectedServiceNameARM.

Spécifiez le type de connexion Azure.


azureClassicSubscription - Abonnement Azure Classic
Alias d’entrée : ConnectedServiceName. string. Nécessaire lorsque ConnectedServiceNameSelector = ConnectedServiceName.

Spécifiez l’abonnement Azure Classic cible.


azureSubscription - Abonnement Azure
Alias d’entrée : ConnectedServiceNameARM. string. Nécessaire lorsque ConnectedServiceNameSelector = ConnectedServiceNameARM.

Spécifiez l’abonnement Azure Resource Manager cible.


Destination - Type de destination
string. Obligatoire. Valeurs autorisées : AzureBlob (Objet blob Azure), AzureVMs (machines virtuelles Azure).

Spécifiez le type de destination à utiliser pour copier les fichiers.


classicStorage - Compte de stockage classique
Alias d’entrée : StorageAccount. string. Nécessaire lorsque ConnectedServiceNameSelector = ConnectedServiceName.

Spécifiez un compte de stockage classique préexistant. Il s’agit du compte de stockage utilisé comme intermédiaire pour la copie de fichiers vers des machines virtuelles Azure.


storage - Compte de stockage RM
Alias d’entrée : StorageAccountRM. string. Nécessaire lorsque ConnectedServiceNameSelector = ConnectedServiceNameARM.

Spécifiez un compte de stockage ARM préexistant. Il s’agit du compte de stockage utilisé comme intermédiaire pour la copie de fichiers vers des machines virtuelles Azure.


ContainerName - Nom du conteneur
string. Nécessaire lorsque Destination = AzureBlob.

Spécifiez le nom du conteneur dans lequel les fichiers sont copiés. Si le conteneur spécifié n’existe pas dans le compte de stockage, il est créé.

Pour créer un répertoire virtuel à l’intérieur du conteneur, utilisez l’entrée de préfixe d’objet blob. Par exemple, pour l’emplacement https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/cible , spécifiez le nom mycontainer du conteneur et le préfixe vd1/vd2d’objet blob .


BlobPrefix - Préfixe de blob
string. facultatif. Utilisez quand Destination = AzureBlob.

Spécifiez un préfixe qui peut être utilisé pour filtrer les fichiers.

Exemple : vous pouvez ajouter un numéro de build pour filtrer les fichiers de tous les objets blob avec le même numéro de build.

Exemple : si vous spécifiez un préfixe myvd1d’objet blob , un répertoire virtuel est créé à l’intérieur du conteneur. Les fichiers sont copiés de la source vers https://myaccount.blob.core.windows.net/mycontainer/myvd1/.


cloudService - Cloud Service
Alias d’entrée : EnvironmentName. string. Nécessaire lorsque ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs.

Spécifiez le nom du service cloud cible.


resourceGroup - Groupe de ressources
Alias d’entrée : EnvironmentNameRM. string. Nécessaire lorsque ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs.

Spécifiez le nom du groupe de ressources cible.


ResourceFilteringMethod - Sélectionner les machines par
string. facultatif. Utilisez quand Destination = AzureVMs. Valeurs autorisées : machineNames (Noms des ordinateurs), tags. Valeur par défaut : machineNames.

Spécifiez le nom d’hôte ou la balise de machine virtuelle qui identifie un sous-ensemble de machines virtuelles dans un groupe de ressources. Les étiquettes sont prises en charge pour les ressources créées via azure Resource Manager uniquement.


MachineNames - Critères de filtre
string. facultatif. Utilisez quand Destination = AzureVMs.

Fournissez une liste des noms d’hôte de machine virtuelle Azure, tels que ffweb, ffdbou des balises telles que Role:DB, Web, OS:Win8.1.

Remarque : Les délimiteurs valides pour les balises incluent ,(virgule), :(colon) et ;(sémicolon). Lorsque vous fournissez plusieurs balises, la tâche s’exécute sur toutes les machines virtuelles qui contiennent les balises spécifiées. Par défaut, la tâche s’exécute dans toutes les machines virtuelles.


vmsAdminUserName - Connexion administrateur
string. Nécessaire lorsque Destination = AzureVMs.

Indiquez le nom d’utilisateur du compte d’administrateur de machine virtuelle Azure.


vmsAdminPassword - Mot de passe
string. Nécessaire lorsque Destination = AzureVMs.

Indiquez le mot de passe du compte d’administrateur de machine virtuelle Azure.

Les entrées valides incluent des variables définies dans les pipelines de build ou de mise en production tels que $(passwordVariable). Pour sécuriser un mot de passe, marquez-le comme secret.


TargetPath - Dossier de destination
string. Nécessaire lorsque Destination = AzureVMs.

Spécifiez le chemin d’accès local sur les machines virtuelles cibles.

Une entrée valide inclut des variables d’environnement telles que $env:windir\BudgetIT\Web.


AdditionalArgumentsForBlobCopy - Arguments facultatifs (pour le chargement des fichiers dans un blob)
string.

Fournissez des arguments supplémentaires à AzCopy.exe qui peuvent être appliqués lors du chargement vers des objets blob tels que /NC:10.

Si aucun argument facultatif n’est spécifié, les arguments suivants sont ajoutés par défaut.

  • /Y
  • /SetContentType
  • /Z
  • /V
  • /S - Ajouté lorsque le nom du conteneur n’est pas $root.
  • /BlobType:page - Ajouté lorsque le compte de stockage spécifié est un compte Premium.
  • /Pattern - Ajouté lorsque le chemin d’accès source est un fichier. Inclus avec tous les autres arguments facultatifs spécifiés.

AdditionalArgumentsForVMCopy - Arguments facultatifs (pour le téléchargement des fichiers sur une machine virtuelle)
string. facultatif. Utilisez quand Destination = AzureVMs.

Fournissez des arguments supplémentaires à AzCopy.exe qui peuvent être appliqués lors du téléchargement sur des machines virtuelles telles que /NC:10.

Si aucun argument facultatif n’est spécifié, les éléments suivants sont ajoutés par défaut.

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

enableCopyPrerequisites - Activer les prérequis de copie
boolean. facultatif. Utilisez quand ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Valeur par défaut : false.

Lorsque cette option est activée, utilise un certificat auto-signé pour configurer un écouteur Windows Remote Management (WinRM) sur le port 5986 au lieu du protocole HTTPS. Obligatoire pour effectuer des opérations de copie sur des machines virtuelles Azure. Si les machines virtuelles cibles utilisent un équilibreur de charge, configurez des règles NAT de trafic entrant pour le port cible (5986). S’applique uniquement aux machines virtuelles ARM.


CopyFilesInParallel - Copier en parallèle
boolean. facultatif. Utilisez quand Destination = AzureVMs. Valeur par défaut : true.

L’acceptation du paramètre par défaut copie les fichiers en parallèle sur les machines virtuelles cibles.


CleanTargetBeforeCopy - Nettoyer la cible
boolean. facultatif. Utilisez quand Destination = AzureVMs. Valeur par défaut : false.

La définition de cette valeur pour true nettoyer le dossier de destination avant d’effectuer l’action de copie.


skipCACheck - Certificat de test
boolean. facultatif. Utilisez quand Destination = AzureVMs. Valeur par défaut : true.

La valeur par défaut ne valide pas que le certificat de serveur a été signé par une autorité de certification approuvée avant la connexion via HTTPS.


outputStorageUri - URI de conteneur de stockage
string.

Spécifiez le nom de la variable utilisée pour l’URI du conteneur de stockage vers lequel les fichiers ont été copiés. Valide uniquement lorsque la destination sélectionnée est un objet Blob Azure.


outputStorageContainerSasToken - Jeton SAP du conteneur de stockage
string.

Spécifiez le nom de la variable utilisée pour le jeton SAP du conteneur de stockage qui accède aux fichiers qui ont été copiés. Valide uniquement lorsque la destination sélectionnée est un objet Blob Azure.


Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Notes

Nouveautés de la version 2.0 : utilisation de la version plus récente d’AzCopy.

Spécifications

Condition requise Description
Types de pipelines YAML, build classique, version classique
S’exécute sur Agent, DeploymentGroup
Demandes Les agents auto-hébergés doivent avoir des fonctionnalités qui correspondent aux exigences suivantes pour exécuter des travaux qui utilisent cette tâche : azureps
Capabilities Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes Quelconque
Variables settables Quelconque
Version de l’agent 1.103.0 ou supérieur
Catégorie de la tâche Déployer