AzureFileCopy@1: tarea de copia de archivos de Azure v1

Copie archivos en Azure Blob Storage o máquinas virtuales.

Nota

Esta tarea no admite la autenticación de Azure Resource Manager con la federación de identidades de flujo de trabajo.

Sintaxis

# Azure file copy v1
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@1
  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. 
    #AdditionalArguments: # string. Additional Arguments. 
    #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.

Entradas

SourcePath - Fuente
string. Obligatorio.

Especifique la ruta de acceso absoluta de la carpeta de origen, el archivo en el equipo local o un recurso compartido UNC. El valor o la expresión especificados deben devolver un nombre de carpeta único o un nombre de archivo.

azureConnectionType - Tipo de conexión de Azure
Alias de entrada: ConnectedServiceNameSelector. string. Valores permitidos: ConnectedServiceName (Azure clásico), ConnectedServiceNameARM (Azure Resource Manager). Valor predeterminado: ConnectedServiceNameARM.

Especifique el tipo de conexión de Azure.

azureClassicSubscription - Suscripción clásica de Azure
Alias de entrada: ConnectedServiceName. string. Necesario cuando ConnectedServiceNameSelector = ConnectedServiceName.

Especifique la suscripción de Azure clásica de destino.

azureSubscription - Suscripción de Azure
Alias de entrada: ConnectedServiceNameARM. string. Necesario cuando ConnectedServiceNameSelector = ConnectedServiceNameARM.

Especifique la suscripción de Azure Resource Manager de destino.

Destination - Tipo de destino
string. Obligatorio. Valores permitidos: AzureBlob (Blob de Azure), AzureVMs (máquinas virtuales de Azure).

Especifique el tipo de destino que se va a usar para copiar los archivos.

classicStorage - Cuenta de almacenamiento clásica
Alias de entrada: StorageAccount. string. Necesario cuando ConnectedServiceNameSelector = ConnectedServiceName.

Especifique una cuenta de almacenamiento clásica existente. Esta es la cuenta de almacenamiento que se usa como intermediario para copiar archivos en máquinas virtuales de Azure.

storage - Cuenta de almacenamiento de RM
Alias de entrada: StorageAccountRM. string. Necesario cuando ConnectedServiceNameSelector = ConnectedServiceNameARM.

Elija una cuenta de almacenamiento de ARM preexistente. Esta es la cuenta de almacenamiento que se usa como intermediario para copiar archivos en máquinas virtuales de Azure.

ContainerName - Nombre del contenedor
string. Necesario cuando Destination = AzureBlob.

Especifique el nombre del contenedor en el que se copian los archivos. Si el contenedor especificado no existe en la cuenta de almacenamiento, se creará.

Para crear un directorio virtual dentro del contenedor, use la entrada de prefijo Blob.

Ejemplo: para la ubicación https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/de destino , especifique el nombre mycontainer del contenedor y el prefijo blob: vd1/vd2.

BlobPrefix - Prefijo de blob
string. Opcional. Use cuando Destination = AzureBlob.

Especifique un prefijo que se pueda usar para filtrar archivos.

Ejemplo: puede anexar un número de compilación para filtrar los archivos de todos los blobs con el mismo número de compilación.

Ejemplo: si especifica un prefijo myvd1blob , se crea un directorio virtual dentro del contenedor. Los archivos se copian del origen a https://myaccount.blob.core.windows.net/mycontainer/myvd1/.

cloudService - Servicio en la nube
Alias de entrada: EnvironmentName. string. Necesario cuando ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs.

Especifique el nombre del servicio en la nube de destino.

resourceGroup - Grupo de recursos
Alias de entrada: EnvironmentNameRM. string. Necesario cuando ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs.

Especifique el nombre del grupo de recursos de destino.

ResourceFilteringMethod - Seleccionar máquinas por
string. Opcional. Use cuando Destination = AzureVMs. Valores permitidos: machineNames (Nombres de máquina), tags. Valor predeterminado: machineNames.

Especifique un nombre de host de máquina virtual o una etiqueta que identifique un subconjunto de máquinas virtuales en un grupo de recursos. Las etiquetas solo se admiten para los recursos creados a través de Azure Resource Manager.

MachineNames - Criterios de filtro
string. Opcional. Use cuando Destination = AzureVMs.

Proporcione una lista de nombres de host de máquina virtual de Azure, como ffweb, o etiquetas como Role:DB, , WebOS:Win8.1. ffdb

Nota: Los delimitadores válidos para las etiquetas incluyen ,(coma), :(colon) y ;(semicolon). Al proporcionar varias etiquetas, la tarea solo se ejecutará en las máquinas virtuales que contienen las etiquetas especificadas. De forma predeterminada, la tarea se ejecuta en todas las máquinas virtuales.

vmsAdminUserName - Inicio de sesión del administrador
string. Necesario cuando Destination = AzureVMs.

Especifique el nombre de usuario de la cuenta de administrador de máquina virtual de Azure.

vmsAdminPassword - Contraseña
string. Necesario cuando Destination = AzureVMs.

Especifique la contraseña de la cuenta de administrador de máquina virtual de Azure.

La entrada válida incluye variables definidas en canalizaciones de compilación o versión, como $(passwordVariable). Para proteger una contraseña, marque como secret.

TargetPath - Carpeta de destino
string. Necesario cuando Destination = AzureVMs.

Especifique la ruta de acceso local en las máquinas virtuales de destino para copiar archivos desde el origen.

La entrada válida incluye variables de entorno como $env:windir\BudgetIT\Web.

AdditionalArguments - Argumentos adicionales
string.

Proporcione argumentos adicionales a AzCopy.exe que se aplicarán al cargar en blobs o máquinas virtuales como , /NC:10.

enableCopyPrerequisites - Habilitar los requisitos previos de copia
boolean. Opcional. Use cuando ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Valor predeterminado: false.

Cuando se habilita, usa un certificado autofirmado para configurar un agente de escucha de Administración remota de Windows (WinRM) en el puerto 5986 en lugar del protocolo HTTPS. Necesario para realizar operaciones de copia en máquinas virtuales de Azure. Si las máquinas virtuales de destino usan un equilibrador de carga, configure las reglas NAT de entrada para el puerto de destino (5986). Solo se aplica a las máquinas virtuales arm.

CopyFilesInParallel - Copiar en paralelo
boolean. Opcional. Use cuando Destination = AzureVMs. Valor predeterminado: true.

Al aceptar la configuración predeterminada, se copian los archivos en paralelo a las máquinas virtuales de destino.

CleanTargetBeforeCopy - Limpiar destino
boolean. Opcional. Use cuando Destination = AzureVMs. Valor predeterminado: false.

Al establecer para true limpiar la carpeta de destino antes de realizar la acción de copia.

skipCACheck - Certificado de prueba
boolean. Opcional. Use cuando Destination = AzureVMs. Valor predeterminado: true.

El valor predeterminado no se validará si el certificado de servidor ha sido firmado por una entidad de certificación de confianza antes de conectarse a través de HTTPS.

outputStorageUri - URI del contenedor de almacenamiento
string.

Especifique el nombre de la variable usada para el URI del contenedor de almacenamiento en el que se copiaron los archivos. Válido solo cuando el destino seleccionado es un blob de Azure.

outputStorageContainerSasToken - Token de SAS del contenedor de almacenamiento
string.

Especifique el nombre de la variable usada para el token de SAS del contenedor de almacenamiento que tiene acceso a los archivos que se copiaron. Válido solo cuando el destino seleccionado es un blob de Azure.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
Peticiones	Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas para ejecutar trabajos que usan esta tarea: azureps
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	1.103.0 o superior
Categoría de la tarea:	Implementación