AzureFileCopy@1 - Tarefa de cópia de ficheiros v1 do Azure

Copie ficheiros para Armazenamento de Blobs do Azure ou máquinas virtuais.

Nota

Esta tarefa não suporta a autenticação Resource Manager do Azure com a federação de identidade do fluxo de trabalho.

Syntax

# 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 - Origem
string. Obrigatório.

Especifique o caminho absoluto da pasta de origem, o ficheiro no computador local ou uma partilha UNC. O valor ou expressão especificado deve devolver um nome de pasta individual ou um nome de ficheiro.

azureConnectionType - Tipo de Ligação do Azure
Alias de entrada: ConnectedServiceNameSelector. string. Valores permitidos: ConnectedServiceName (Azure Classic), ConnectedServiceNameARM (Azure Resource Manager). Valor predefinido: ConnectedServiceNameARM.

Especifique o tipo de ligação do Azure.

azureClassicSubscription - Subscrição Clássica do Azure
Alias de entrada: ConnectedServiceName. string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceName.

Especifique a subscrição clássica do Azure de destino.

azureSubscription - Subscrição do Azure
Alias de entrada: ConnectedServiceNameARM. string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameARM.

Especifique a subscrição do Azure Resource Manager de destino.

Destination - Tipo de Destino
string. Obrigatório. Valores permitidos: AzureBlob (Blob do Azure), AzureVMs (VMs do Azure).

Especifique o tipo de destino a utilizar para copiar os ficheiros.

classicStorage - Conta de Armazenamento Clássica
Alias de entrada: StorageAccount. string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceName.

Especifique uma conta de armazenamento clássica pré-existente. Esta é a conta de armazenamento utilizada como intermediário para copiar ficheiros para VMs do Azure.

storage - Conta de Armazenamento RM
Alias de entrada: StorageAccountRM. string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameARM.

Especifique uma conta de armazenamento arm pré-existente. Esta é a conta de armazenamento utilizada como intermediário para copiar ficheiros para VMs do Azure.

ContainerName - Nome do Contentor
string. Necessário quando Destination = AzureBlob.

Especifique o nome do contentor no qual os ficheiros são copiados. Se o contentor especificado não existir na conta de armazenamento, será criado.

Para criar um diretório virtual dentro do contentor, utilize a entrada do prefixo blob.

Exemplo: para localização https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/de destino, especifique o nome mycontainer do contentor e o prefixo blob: vd1/vd2.

BlobPrefix - Prefixo de Blobs
string. Opcional. Utilize quando Destination = AzureBlob.

Especifique um prefixo que pode ser utilizado para filtrar ficheiros.

Exemplo: pode acrescentar um número de compilação para filtrar os ficheiros de todos os Blobs com o mesmo número de compilação.

Exemplo: se especificar um prefixo myvd1de Blob, é criado um diretório virtual dentro do contentor. Os ficheiros são copiados da origem para https://myaccount.blob.core.windows.net/mycontainer/myvd1/.

cloudService - Serviço Cloud
Alias de entrada: EnvironmentName. string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs.

Especifique o nome do Serviço Cloud de destino.

resourceGroup - Grupo de Recursos
Alias de entrada: EnvironmentNameRM. string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs.

Especifique o nome do Grupo de Recursos de destino.

ResourceFilteringMethod - Selecionar Máquinas Por
string. Opcional. Utilize quando Destination = AzureVMs. Valores permitidos: machineNames (Nomes das Máquinas), tags. Valor predefinido: machineNames.

Especifique um nome ou etiqueta de anfitrião de VM que identifique um subconjunto de VMs num grupo de recursos. As etiquetas são suportadas para recursos criados apenas através do Azure Resource Manager.

MachineNames - Critérios de Filtro
string. Opcional. Utilize quando Destination = AzureVMs.

Forneça uma lista de nomes de anfitriões de VMs do Azure, tais como ffweb, ou etiquetas como Role:DB, , WebOS:Win8.1. ffdb

Nota: os delimitadores válidos para etiquetas incluem ,(vírgula), :(colon) e ;(semicolon). Ao fornecer várias etiquetas, a tarefa será executada apenas nas VMs que contêm as etiquetas especificadas. Por predefinição, a tarefa é executada em todas as VMs.

vmsAdminUserName - Início de Sessão do Administração
string. Necessário quando Destination = AzureVMs.

Especifique o nome de utilizador da conta de administrador da VM do Azure.

vmsAdminPassword - Palavra-passe
string. Necessário quando Destination = AzureVMs.

Especifique a palavra-passe da conta de administrador da VM do Azure.

A entrada válida inclui variáveis definidas em pipelines de compilação ou versão, como $(passwordVariable). Para proteger uma palavra-passe, marque-a como secret.

TargetPath - Pasta de Destino
string. Necessário quando Destination = AzureVMs.

Especifique o caminho local nas VMs de destino para copiar ficheiros da origem.

A entrada válida inclui variáveis de ambiente, como $env:windir\BudgetIT\Web.

AdditionalArguments - Argumentos Adicionais
string.

Indique argumentos adicionais para que sejam aplicados ao AzCopy.exe carregar para Blobs ou VMs, tais como . /NC:10

enableCopyPrerequisites - Ativar Pré-requisitos de Cópia
boolean. Opcional. Utilize quando ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Valor predefinido: false.

Quando ativado, utiliza um certificado autoassinado para configurar um serviço de escuta de Gestão Remota do Windows (WinRM) na porta 5986 em vez do protocolo HTTPS. Necessário para realizar operações de cópia em VMs do Azure. Se as VMs de destino utilizarem um balanceador de carga, configure regras NAT de entrada para a porta de destino (5986). Aplica-se apenas a VMs do ARM.

CopyFilesInParallel - Copiar em Paralelo
boolean. Opcional. Utilize quando Destination = AzureVMs. Valor predefinido: true.

Aceitar a predefinição copia ficheiros em paralelo para as VMs de destino.

CleanTargetBeforeCopy - Destino Limpo
boolean. Opcional. Utilize quando Destination = AzureVMs. Valor predefinido: false.

A definição para true limpar a pasta de destino antes de efetuar a ação de cópia.

skipCACheck - Testar Certificado
boolean. Opcional. Utilize quando Destination = AzureVMs. Valor predefinido: true.

O valor predefinido não validará se o certificado de servidor foi assinado por uma AC fidedigna antes de ligar através de HTTPS.

outputStorageUri - URI do Contentor de Armazenamento
string.

Especifique o nome da variável utilizada para o URI do contentor de armazenamento para o qual os ficheiros foram copiados. Válido apenas quando o destino selecionado é um Blob do Azure.

outputStorageContainerSasToken - Token de SAS de Contentor de Armazenamento
string.

Especifique o nome da variável utilizada para o token de SAS do contentor de armazenamento que acede aos ficheiros que foram copiados. Válido apenas quando o destino selecionado é um Blob do Azure.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica, Versão clássica
É executado em	Agent, DeploymentGroup
Exigências	Os agentes autoalojados têm de ter capacidades que correspondam às seguintes exigências para executar tarefas que utilizem esta tarefa: azureps
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Qualquer
Variáveis de definição	Qualquer
Versão do agente	1.103.0 ou superior
Categoria da tarefa	Implementação