Sdílet prostřednictvím


AzureFileCopy@1 – úloha Kopírování souborů Azure v1

Zkopírujte soubory do Azure Blob Storage nebo virtuálních počítačů.

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.
# Azure File Copy v1
# Copy files to Azure blob or VM(s).
- 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.

Vstupy

SourcePath - Zdroj
string. Povinná hodnota.

Zadejte absolutní cestu ke zdrojové složce, souboru na místním počítači nebo sdílené složce UNC. Zadaná hodnota nebo výraz by měl vrátit buď jeden název složky, nebo název souboru.


azureConnectionType - Typ připojení Azure
Vstupní alias: ConnectedServiceNameSelector. string. Povolené hodnoty: ConnectedServiceName (Azure Classic) ConnectedServiceNameARM (Azure Resource Manager). Výchozí hodnota: ConnectedServiceNameARM.

Zadejte typ připojení Azure.


azureClassicSubscription - Předplatné Azure Classic
Vstupní alias: ConnectedServiceName. string. Vyžaduje se, když ConnectedServiceNameSelector = ConnectedServiceName.

Zadejte cílové předplatné Azure Classic.


azureSubscription - Předplatné Azure
Vstupní alias: ConnectedServiceNameARM. string. Vyžaduje se, když ConnectedServiceNameSelector = ConnectedServiceNameARM.

Zadejte cílové předplatné Azure Resource Manager.


Destination - Typ cíle
string. Povinná hodnota. Povolené hodnoty: AzureBlob (Azure Blob) AzureVMs (virtuální počítače Azure).

Zadejte cílový typ, který se má použít pro kopírování souborů.


classicStorage - Klasický účet úložiště
Vstupní alias: StorageAccount. string. Vyžaduje se, když ConnectedServiceNameSelector = ConnectedServiceName.

Zadejte existující klasický účet úložiště. Jedná se o účet úložiště, který se používá jako zprostředkovatel pro kopírování souborů do virtuálních počítačů Azure.


storage - Účet úložiště RM
Vstupní alias: StorageAccountRM. string. Vyžaduje se, když ConnectedServiceNameSelector = ConnectedServiceNameARM.

Zadejte existující účet úložiště ARM. Jedná se o účet úložiště, který se používá jako zprostředkovatel pro kopírování souborů do virtuálních počítačů Azure.


ContainerName - Název kontejneru
string. Vyžaduje se, když Destination = AzureBlob.

Zadejte název kontejneru, do kterého se soubory kopírují. Pokud zadaný kontejner v účtu úložiště neexistuje, vytvoří se.

K vytvoření virtuálního adresáře uvnitř kontejneru použijte vstup předpony objektu blob.

Příklad: Pro cílové umístění https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/zadejte název mycontainer kontejneru a předponu objektu blob: vd1/vd2.


BlobPrefix - Předpona objektu blob
string. Nepovinný parametr. Použijte, když Destination = AzureBlob.

Zadejte předponu, která se dá použít k filtrování souborů.

Příklad: Můžete připojit číslo sestavení a filtrovat soubory ze všech objektů blob se stejným číslem sestavení.

Příklad: Pokud zadáte předponu myvd1objektu blob , vytvoří se v kontejneru virtuální adresář. Soubory se zkopírují ze zdroje do https://myaccount.blob.core.windows.net/mycontainer/myvd1/.


cloudService - Cloudová služba
Vstupní alias: EnvironmentName. string. Vyžaduje se, když ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs.

Zadejte název cílové cloudové služby.


resourceGroup - Skupina prostředků
Vstupní alias: EnvironmentNameRM. string. Vyžaduje se, když ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs.

Zadejte název cílové skupiny prostředků.


ResourceFilteringMethod - Vybrat počítače podle
string. Nepovinný parametr. Použijte, když Destination = AzureVMs. Povolené hodnoty: machineNames (Názvy počítačů), tags. Výchozí hodnota: machineNames.

Zadejte název nebo značku hostitele virtuálního počítače, která identifikuje podmnožinu virtuálních počítačů ve skupině prostředků. Značky se podporují jenom pro prostředky vytvořené prostřednictvím azure Resource Manager.


MachineNames - Kritéria filtru
string. Nepovinný parametr. Použijte, když Destination = AzureVMs.

Zadejte seznam názvů hostitelů virtuálních počítačů Azure, například ffweb, ffdbnebo značek, jako Role:DBje , Web, OS:Win8.1.

Poznámka: Platné oddělovače pro značky zahrnují ,(čárka), :(colon) a ;(semicolon). Při poskytování více značek se úloha spustí jenom na virtuálních počítačích, které obsahují zadané značky. Ve výchozím nastavení se úloha spouští na všech virtuálních počítačích.


vmsAdminUserName - přihlášení Správa
string. Vyžaduje se, když Destination = AzureVMs.

Zadejte uživatelské jméno účtu správce virtuálního počítače Azure.


vmsAdminPassword - Heslo
string. Vyžaduje se, když Destination = AzureVMs.

Zadejte heslo pro účet správce virtuálního počítače Azure.

Platný vstup zahrnuje proměnné definované v kanálech sestavení nebo verze, jako $(passwordVariable)je . Pokud chcete heslo zabezpečit, označte ho jako secret.


TargetPath - Cílová složka
string. Vyžaduje se, když Destination = AzureVMs.

Zadejte místní cestu na cílových virtuálních počítačích pro kopírování souborů ze zdroje.

Platný vstup zahrnuje proměnné prostředí, jako $env:windir\BudgetIT\Webje .


AdditionalArguments - Další argumenty
string.

Zadejte další argumenty AzCopy.exe , které se použijí při nahrávání do objektů blob nebo virtuálních počítačů, /NC:10například .


enableCopyPrerequisites - Povolení požadavků na kopírování
boolean. Nepovinný parametr. Použijte, když ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Výchozí hodnota: false.

Pokud je povoleno, používá certifikát podepsaný svým držitelem ke konfiguraci naslouchacího procesu Vzdálené správy systému Windows (WinRM) na portu 5986 místo protokolu HTTPS. Vyžaduje se pro provádění operací kopírování na virtuálních počítačích Azure. Pokud cílové virtuální počítače používají nástroj pro vyrovnávání zatížení, nakonfigurujte příchozí pravidla překladu adres (NAT) pro cílový port (5986). Platí jenom pro virtuální počítače ARM.


CopyFilesInParallel - Paralelní kopírování
boolean. Nepovinný parametr. Použijte, když Destination = AzureVMs. Výchozí hodnota: true.

Přijetí výchozího nastavení zkopíruje soubory paralelně do cílových virtuálních počítačů.


CleanTargetBeforeCopy - Čistý cíl
boolean. Nepovinný parametr. Použijte, když Destination = AzureVMs. Výchozí hodnota: false.

Nastavení na true cílovou složku před provedením akce kopírování vyčistí.


skipCACheck - Test certifikátu
boolean. Nepovinný parametr. Použijte, když Destination = AzureVMs. Výchozí hodnota: true.

Výchozí hodnota neověří, jestli byl certifikát serveru před připojením přes HTTPS podepsán důvěryhodnou certifikační autoritou.


outputStorageUri - Identifikátor URI kontejneru úložiště
string.

Zadejte název proměnné použité pro identifikátor URI kontejneru úložiště, do kterého se soubory zkopírovaly. Platí jenom v případech, kdy je vybraným cílem objekt blob Azure.


outputStorageContainerSasToken - Token SAS kontejneru úložiště
string.

Zadejte název proměnné použité pro token SAS kontejneru úložiště, který přistupuje k zkopírovaným souborům. Platí jenom v případech, kdy je vybraným cílem objekt blob Azure.


Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Požadavky

Požadavek Popis
Typy kanálů YAML, classic build, verze Classic
Spustí se Agent, DeploymentGroup
Požadavky Agenti v místním prostředí musí mít funkce , které odpovídají následujícím požadavkům na spouštění úloh, které používají tuto úlohu: azureps
Možnosti Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů Všechny
Nastavitelné proměnné Všechny
Verze agenta 1.103.0 nebo vyšší
Kategorie úloh Nasazení