Compartir a través de


AzureFileCopy@1: tarea copia de archivos de Azure v1

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

Esta tarea está en desuso, ya que esta versión de la tarea AzureFileCopy usa una versión retirada de AzCopy. Use la versión más reciente de la tarea AzureFileCopy. Consulte Guía de migración de AzCopy para v8 a v10.

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

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 - origen
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 solo nombre de carpeta o un nombre de archivo.


azureConnectionType - de 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 - de suscripción clásica de Azure
Alias de entrada: ConnectedServiceName. string. Obligatorio cuando ConnectedServiceNameSelector = ConnectedServiceName.

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


azureSubscription - de suscripción de Azure
Alias de entrada: ConnectedServiceNameARM. string. Obligatorio cuando ConnectedServiceNameSelector = ConnectedServiceNameARM.

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


tipo de destino de Destination -
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 - de cuenta de almacenamiento clásica
Alias de entrada: StorageAccount. string. Obligatorio cuando ConnectedServiceNameSelector = ConnectedServiceName.

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


storage - de cuenta de almacenamiento de RM
Alias de entrada: StorageAccountRM. string. Obligatorio cuando ConnectedServiceNameSelector = ConnectedServiceNameARM.

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


ContainerName - nombre de contenedor
string. Obligatorio 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 de destino https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/, especifique el nombre del contenedor mycontainer y el prefijo blob: vd1/vd2.


de prefijo de blob de BlobPrefix -
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 blob myvd1, se crea un directorio virtual dentro del contenedor. Los archivos se copian del origen en https://myaccount.blob.core.windows.net/mycontainer/myvd1/.


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

Especifique el nombre del servicio en la nube de destino.


de grupo de recursos de resourceGroup -
Alias de entrada: EnvironmentNameRM. string. Obligatorio 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 o etiqueta de máquina virtual que identifique un subconjunto de máquinas virtuales de un grupo de recursos. 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, ffdbo etiquetas como Role:DB, Web, OS:Win8.1.

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.


de inicio de sesión de administrador de vmsAdminUserName -
string. Obligatorio cuando Destination = AzureVMs.

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


de contraseña de vmsAdminPassword -
string. Obligatorio 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.


carpeta de destino de TargetPath -
string. Obligatorio 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 para AzCopy.exe que se aplicarán al cargar en blobs o máquinas virtuales como, por ejemplo, /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 reglas NAT de entrada para el puerto de destino (5986). Solo se aplica a las máquinas virtuales arm.


copia de CopyFilesInParallel - en 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 - de destino limpio
boolean. Opcional. Use cuando Destination = AzureVMs. Valor predeterminado: false.

Al establecer en true limpia la carpeta de destino antes de realizar la acción de copia.


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

El valor predeterminado no validará si 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 al 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 sus entradas de tarea. Para obtener más información, consulte 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
demandas Los agentes autohospedados deben tener funcionalidades que coincidan con los siguientes exigen ejecutar trabajos que usen esta tarea: azureps
funcionalidades de Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos Cualquiera
variables settable Cualquiera
Versión del agente 1.103.0 o superior
Categoría de tarea Desplegar