Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Copie arquivos para o Armazenamento de Blobs do Azure ou máquinas virtuais.
Essa tarefa foi preterida, pois essa versão da tarefa AzureFileCopy usa uma versão desativada do AzCopy. Use a versão mais recente da tarefa AzureFileCopy. Consulte Guia de Migração do AzCopy para v8 para v10.
Observação
Essa tarefa não dá suporte a autenticação do Azure Resource Manager comde federação de identidade de fluxo de trabalho.
Copie arquivos para o Armazenamento de Blobs do Azure ou máquinas virtuais.
Observação
Essa tarefa não dá suporte a autenticação do Azure Resource Manager comde federação de identidade de fluxo de trabalho.
Sintaxe
# 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
-
de origem
string. Obrigatório
Especifique o caminho absoluto para a pasta de origem, o arquivo no computador local ou um compartilhamento UNC. O valor ou expressão especificado deve retornar um nome de pasta única ou um nome de arquivo.
azureConnectionType
-
tipo de conexão do Azure
Alias de entrada: ConnectedServiceNameSelector.
string. Valores permitidos: ConnectedServiceName (Azure Classic), ConnectedServiceNameARM (Azure Resource Manager). Valor padrão: ConnectedServiceNameARM.
Especifique o tipo de conexão do Azure.
azureClassicSubscription
-
de Assinatura Clássica do Azure
Alias de entrada: ConnectedServiceName.
string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceName.
Especifique a assinatura do Azure Classic de destino.
azureSubscription
-
assinatura do Azure
Alias de entrada: ConnectedServiceNameARM.
string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameARM.
Especifique a assinatura de destino do Azure Resource Manager.
Destination
-
tipo de destino
string. Obrigatório Valores permitidos: AzureBlob (Blob do Azure), AzureVMs (VMs do Azure).
Especifique o tipo de destino a ser usado para copiar os arquivos.
classicStorage
-
de conta de armazenamento clássico
Alias de entrada: StorageAccount.
string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceName.
Especifique uma conta de armazenamento clássica pré-existente. Essa é a conta de armazenamento usada como intermediário para copiar arquivos para VMs do Azure.
storage
-
conta de armazenamento RM
Alias de entrada: StorageAccountRM.
string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameARM.
Especifique uma conta de armazenamento do ARM pré-existente. Essa é a conta de armazenamento usada como intermediário para copiar arquivos para VMs do Azure.
de nome do contêiner ContainerName -
string. Necessário quando Destination = AzureBlob.
Especifique o nome do contêiner no qual os arquivos são copiados. Se o contêiner especificado não existir na conta de armazenamento, ele será criado.
Para criar um diretório virtual dentro do contêiner, use a entrada de prefixo blob. Por exemplo, para o local de destino https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/, especifique o nome do contêiner mycontainer e o prefixo de blob vd1/vd2.
BlobPrefix
-
prefixo de blob
string. Opcional. Use quando Destination = AzureBlob.
Especifique um prefixo que pode ser usado para filtrar arquivos.
Exemplo: você pode acrescentar um número de build para filtrar os arquivos de todos os Blobs com o mesmo número de build.
Exemplo: se você especificar um prefixo de Blob myvd1, um diretório virtual será criado dentro do contêiner. Os arquivos são copiados da origem para o https://myaccount.blob.core.windows.net/mycontainer/myvd1/.
do Serviço de Nuvem do cloudService -
Alias de entrada: EnvironmentName.
string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs.
Especifique o nome do Serviço de Nuvem de destino.
do Grupo de Recursos do resourceGroup -
Alias de entrada: EnvironmentNameRM.
string. Necessário quando ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs.
Especifique o nome do Grupo de Recursos de destino.
ResourceFilteringMethod
-
selecionar computadores
string. Opcional. Use quando Destination = AzureVMs. Valores permitidos: machineNames (Nomes de Máquina), tags. Valor padrão: machineNames.
Especifique o nome ou a marca do host da VM que identifica um subconjunto de VMs em um grupo de recursos. marcas têm suporte apenas para recursos criados por meio do Azure Resource Manager.
critérios de filtro de MachineNames -
string. Opcional. Use quando Destination = AzureVMs.
Forneça uma lista de nomes de host de VM do Azure, como ffweb, ffdbou marcas como Role:DB, Web, OS:Win8.1.
Observação: delimitadores válidos para marcas incluem ,(vírgula), :(colon) e ;(semicolon). Ao fornecer várias marcas, a tarefa será executada em todas as VMs que contêm as marcas especificadas. Por padrão, a tarefa é executada em todas as VMs.
de Logon do Administrador do vmsAdminUserName -
string. Necessário quando Destination = AzureVMs.
Forneça o nome de usuário da conta de administrador da VM do Azure.
vmsAdminPassword
-
de senha
string. Necessário quando Destination = AzureVMs.
Forneça a senha para a conta de administrador da VM do Azure.
A entrada válida inclui variáveis definidas em pipelines de build ou lançamento, como $(passwordVariable). Para proteger uma senha, marque-a como secret.
da Pasta de Destino TargetPath -
string. Necessário quando Destination = AzureVMs.
Especifique o caminho local nas VMs de destino.
A entrada válida inclui variáveis de ambiente, como $env:windir\BudgetIT\Web.
AdditionalArgumentsForBlobCopy
-
argumentos opcionais (para carregar arquivos no blob)
string.
Forneça argumentos adicionais para AzCopy.exe que podem ser aplicados ao carregar em Blobs, como /NC:10.
Se nenhum argumento opcional for especificado, os argumentos a seguir serão adicionados por padrão.
/Y/SetContentType/Z/V-
/S- Adicionado quando o nome do contêiner não é$root. -
/BlobType:page– adicionada quando a conta de armazenamento especificada é uma conta premium. -
/Pattern– adicionado quando o caminho de origem é um arquivo. Incluído com quaisquer outros argumentos opcionais especificados.
AdditionalArgumentsForVMCopy
-
argumentos opcionais (para baixar arquivos na VM)
string. Opcional. Use quando Destination = AzureVMs.
Forneça argumentos adicionais para AzCopy.exe que podem ser aplicados ao baixar em VMs como /NC:10.
Se nenhum argumento opcional for especificado, os seguintes serão adicionados por padrão.
/Y/S/Z/V
enableCopyPrerequisites
-
habilitar a cópia de pré-requisitos
boolean. Opcional. Use quando ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Valor padrão: false.
Quando habilitado, usa um certificado autoassinado para configurar um ouvinte do WinRM (Gerenciamento Remoto do Windows) na porta 5986 em vez do protocolo HTTPS. Necessário para executar operações de cópia em VMs do Azure. Se as VMs de destino usarem um balanceador de carga, configure as regras NAT de entrada para a porta de destino (5986). Aplica-se somente a VMs arm.
copiar CopyFilesInParallel - em paralela
boolean. Opcional. Use quando Destination = AzureVMs. Valor padrão: true.
Aceitar a configuração padrão copia arquivos em paralelo às VMs de destino.
CleanTargetBeforeCopy
-
de destino limpo
boolean. Opcional. Use quando Destination = AzureVMs. Valor padrão: false.
Definir esse valor para true limpa a pasta de destino antes de executar a ação de cópia.
skipCACheck
-
de certificado de teste
boolean. Opcional. Use quando Destination = AzureVMs. Valor padrão: true.
O valor padrão não validará se o certificado do servidor foi assinado por uma AC confiável antes de se conectar por HTTPS.
de URI do Contêiner de Armazenamento outputStorageUri -
string.
Especifique o nome da variável usada para o URI do contêiner de armazenamento para o qual os arquivos foram copiados. Válido somente quando o destino selecionado for um Blob do Azure.
outputStorageContainerSasToken
-
token SAS do contêiner de armazenamento
string.
Especifique o nome da variável usada para o token SAS do contêiner de armazenamento que acessa os arquivos que foram copiados. Válido somente quando o destino selecionado for um Blob do Azure.
Opções de controle de tarefa
Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.
Variáveis de saída
Nenhum.
Observações
Novidades na versão 2.0: usando a versão mais recente do AzCopy.
Requisitos
| Requisito | Descrição |
|---|---|
| Tipos de pipeline | YAML, build clássico, versão clássica |
| Execuções em | Agent, DeploymentGroup |
| de demandas | Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas de para executar trabalhos que usam esta tarefa: azureps |
| recursos | Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho. |
| restrições de comando | Qualquer |
| variáveis settable | Qualquer |
| Versão do agente | 1.103.0 ou superior |
| Categoria de tarefa | Implantar |