AzureFileCopy@2: tarea copia de archivos de Azure v2

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

Entradas

SourcePath - Fuente
string. Obligatorio.

Especifique la ruta de acceso absoluta a 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. Por 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 vd1/vd2blob .

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 el nombre de host de máquina virtual o la etiqueta que identifica un subconjunto de máquinas virtuales de 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 se ejecutará en todas las máquinas virtuales que contengan 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.

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

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

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

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

AdditionalArgumentsForBlobCopy - Argumentos opcionales (para cargar archivos en el blob)
string.

Proporcione argumentos adicionales a AzCopy.exe que se pueden aplicar al cargar en blobs como /NC:10.

Si no se especifica ningún argumento opcional, los argumentos siguientes se agregan de forma predeterminada.

• /Y
• /SetContentType
• /Z
• /V
• /S : se agrega cuando el nombre del contenedor no $rootes .
• /BlobType:page - Se agrega cuando la cuenta de almacenamiento especificada es una cuenta Premium.
• /Pattern : se agrega cuando la ruta de acceso de origen es un archivo. Se incluye con cualquier otro argumento opcional especificado.

AdditionalArgumentsForVMCopy - Argumentos opcionales (para descargar archivos en la máquina virtual)
string. Opcional. Use cuando Destination = AzureVMs.

Proporcione argumentos adicionales a AzCopy.exe que se pueden aplicar al descargar en máquinas virtuales como /NC:10.

Si no se especifica ningún argumento opcional, se agrega lo siguiente de forma predeterminada.

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

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.

Si se establece este valor en , true se limpia 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 validará que un ca de confianza firmó el certificado de servidor 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.

Comentarios

Novedades de la versión 2.0: Uso de la versión más reciente de AzCopy.

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