AzureFileCopy@2 – úloha Kopírování souborů Azure v2

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

Poznámka

Tato úloha nepodporuje ověřování Azure Resource Manager s federací identit pracovních postupů.

Syntax

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

Vstupy

SourcePath - Zdroj
string. Povinná hodnota.

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

azureConnectionType - Typ připojení Azure
Alias vstupu: 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
Alias vstupu: ConnectedServiceName. string. Vyžaduje se, když ConnectedServiceNameSelector = ConnectedServiceName.

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

azureSubscription - Předplatné Azure
Alias vstupu: 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 typ cíle, který se má použít ke kopírování souborů.

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

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

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

Zadejte existující účet úložiště ARM. Jedná se o účet úložiště, který slouží 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. Například pro cílové umístění https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/zadejte název mycontainer kontejneru a předponu vd1/vd2objektu blob .

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
Alias vstupu: EnvironmentName. string. Vyžaduje se, když ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs.

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

resourceGroup - Skupina prostředků
Alias vstupu: 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: Mezi platné oddělovače značek patří čárka, :(colon) a ;(semicolon). Při poskytování více značek se úloha spustí ve všech 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 buildu nebo verze, jako $(passwordVariable)je . Pokud chcete zabezpečit heslo, 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.

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

AdditionalArgumentsForBlobCopy - Volitelné argumenty (pro nahrávání souborů do objektu blob)
string.

Zadejte další argumenty AzCopy.exe , které je možné použít při nahrávání do objektů blob, jako /NC:10je .

Pokud nejsou zadány žádné volitelné argumenty, jsou ve výchozím nastavení přidány následující argumenty.

• /Y
• /SetContentType
• /Z
• /V
• /S – Přidáno, pokud název kontejneru není $root.
• /BlobType:page – Přidáno, pokud je zadaným účtem úložiště účet Premium.
• /Pattern – Přidáno, pokud je zdrojovou cestou soubor. Součástí všech dalších zadaných volitelných argumentů.

AdditionalArgumentsForVMCopy - Volitelné argumenty (pro stahování souborů do virtuálního počítače)
string. Nepovinný parametr. Použijte, když Destination = AzureVMs.

Zadejte další argumenty AzCopy.exe , které lze použít při stahování do virtuálních počítačů, jako /NC:10je .

Pokud nejsou zadány žádné volitelné argumenty, jsou ve výchozím nastavení přidány následující.

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

enableCopyPrerequisites - Povolení požadovaných součástí 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ím této hodnoty na true cílovou složku se 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ěří, že certifikát serveru byl 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é

Poznámky

Co je nového ve verzi 2.0: Použití novější verze Nástroje AzCopy

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í