AzureFileCopy@3 – úloha Kopírování souborů Azure v3

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

# Azure file copy v3
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@3
  inputs:
    SourcePath: # string. Required. Source. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required. Azure Subscription. 
    Destination: # 'AzureBlob' | 'AzureVMs'. Required. Destination Type. 
    storage: # string. Alias: StorageAccountRM. Required. RM Storage Account. 
    #ContainerName: # string. Required when Destination = AzureBlob. Container Name. 
    #BlobPrefix: # string. Optional. Use when Destination = AzureBlob. Blob Prefix. 
    #resourceGroup: # string. Alias: EnvironmentNameRM. Required when 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 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. 
    #sasTokenTimeOutInMinutes: # string. SAS Token Expiration Period In Minutes.

SourcePath - Zdroj
string. Povinná hodnota.

Zadejte absolutní cestu ke zdrojové složce nebo souboru v místním počítači nebo sdílené složce UNC. Můžete použít předdefinované systémové proměnné, jako $(Build.Repository.LocalPath)je . Názvy obsahující zástupné cardy, jako *.zip jsou, nejsou podporovány. Zadaná hodnota nebo výraz by měl vrátit jeden název složky nebo souboru.

azureSubscription - Předplatné Azure
Alias vstupu: ConnectedServiceNameARM. string. Povinná hodnota.

Zadejte název připojení služby Azure Resource Manager nakonfigurované pro předplatné, ve kterém se nachází cílová služba Azure, virtuální počítač nebo účet úložiště. Další podrobnosti najdete v tématu Přehled 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.

storage - Účet úložiště RM
Alias vstupu: StorageAccountRM. string. Povinná hodnota.

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.

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

Pokud chcete v kontejneru vytvořit virtuální adresář, 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 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/.

resourceGroup - Skupina prostředků
Alias vstupu: EnvironmentNameRM. string. Vyžaduje se, když Destination = AzureVMs.

Zadejte název cílové skupiny prostředků, do které se budou soubory kopírovat.

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ů virtuálních počítačů nebo názvů značek, které identifikují virtuální počítače, na které bude úkol cílit. Mezi platná kritéria filtru patří:

• Název skupiny prostředků Azure.
• Výstupní proměnná z předchozího úkolu.
• Seznam názvů značek nebo názvů virtuálních počítačů oddělených čárkami.
• Názvy virtuálních počítačů můžete formátovat pomocí seznamu plně kvalifikovaných názvů domén nebo IP adres oddělených čárkami.
• Formátovat názvy značek pro filtr jako {TagName}:{Value}. Příklad: Role:DB;OS:Win8.1, ffweb, ffdbnebo značky jako Role:DB, 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í 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 s oprávněními správce na všech cílových virtuálních počítačích.

• Mezi podporované formáty patří: username, domain\username, machine-name\usernamea .\username.
• Formáty hlavního názvu uživatele (UPN), včetně username@domain.com předdefinovaných systémových účtů, jako NT Authority\System jsou , se nepodporují.

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

Zadejte heslo správce virtuálních počítačů.

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 cestu ke složce na virtuálních počítačích Azure, do které se budou soubory kopírovat.

Podporují se proměnné prostředí, jako $env:windir jsou a $env:systemroot . Příklady: $env:windir\FabrikamFiber\Web a c:\FabrikamFiber

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ž Destination = AzureVMs. Výchozí hodnota: false.

Pokud je tato možnost povolená, 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í operace 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 pro cílový port (5986). Platí jenom pro virtuální počítače ARM. Na cílových virtuálních počítačích přidružených ke skupině zabezpečení sítě (NSG) nakonfigurujte příchozí pravidlo zabezpečení, které povolí přístup na portu 5986.

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

Zadejte true , aby se soubory zkopírovaly paralelně do cílových virtuálních počítačů. Použití této hodnoty může zkrátit celkovou dobu potřebnou k provedení akce.

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

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

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

Výchozí hodnota neověří, jestli certifikát serveru před připojením přes protokol HTTPS podepsala důvěryhodná certifikační autorita.

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í pouze 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 ke zkopírovaným souborům. Tuto proměnnou použijte jako vstup pro následné úlohy. Ve výchozím nastavení platnost tokenu SAS vyprší po 4 hodinách.

sasTokenTimeOutInMinutes - Doba vypršení platnosti tokenu SAS v minutách
string.

Zadejte čas v minutách, po kterém vyprší platnost tokenu SAS. Platí jenom v případech, kdy je vybraným cílem Azure Blob.

Žádné