AzureFileCopy@2 – Azure-fájlmásolási v2-feladat

Fájlok másolása Azure Blob Storage vagy virtuális gépekre.

Megjegyzés

Ez a feladat nem támogatja az Azure Resource Manager-hitelesítést a munkafolyamat-identitások összevonásával.

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.

Bevitelek

SourcePath - Forrás
string. Kötelező.

Adja meg a forrásmappa, a helyi gépen található fájl vagy egy UNC-megosztás abszolút elérési útját. A megadott értéknek vagy kifejezésnek egyetlen mappanevet vagy fájlnevet kell visszaadnia.

azureConnectionType - Azure-kapcsolat típusa
Bemeneti alias: ConnectedServiceNameSelector. string. Engedélyezett értékek: ConnectedServiceName (Klasszikus Azure), ConnectedServiceNameARM (Azure Resource Manager). Alapértelmezett érték: ConnectedServiceNameARM.

Adja meg az Azure-kapcsolat típusát.

azureClassicSubscription - Klasszikus Azure-előfizetés
Bemeneti alias: ConnectedServiceName. string. Akkor szükséges, ha ConnectedServiceNameSelector = ConnectedServiceName.

Adja meg a klasszikus Azure-előfizetést.

azureSubscription - Azure-előfizetés
Bemeneti alias: ConnectedServiceNameARM. string. Akkor szükséges, ha ConnectedServiceNameSelector = ConnectedServiceNameARM.

Adja meg a cél Azure Resource Manager-előfizetést.

Destination - Cél típusa
string. Kötelező. Engedélyezett értékek: AzureBlob (Azure Blob), AzureVMs (Azure-beli virtuális gépek).

Adja meg a fájlok másolásához használni kívánt céltípust.

classicStorage - Klasszikus tárfiók
Bemeneti alias: StorageAccount. string. Akkor szükséges, ha ConnectedServiceNameSelector = ConnectedServiceName.

Adjon meg egy már meglévő klasszikus tárfiókot. Ez a tárfiók a fájlok Azure-beli virtuális gépekre történő másolásának közvetítőjeként.

storage - RM-tárfiók
Bemeneti alias: StorageAccountRM. string. Akkor szükséges, ha ConnectedServiceNameSelector = ConnectedServiceNameARM.

Adjon meg egy már meglévő ARM-tárfiókot. Ez a tárfiók a fájlok Azure-beli virtuális gépekre történő másolásának közvetítőjeként.

ContainerName - Tároló neve
string. Akkor szükséges, ha Destination = AzureBlob.

Adja meg annak a tárolónak a nevét, amelybe a fájlokat átmásolja. Ha a megadott tároló nem létezik a tárfiókban, akkor létrejön.

Ha virtuális könyvtárat szeretne létrehozni a tárolóban, használja a Blob előtag bemenetét. A célhelyhez https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/például adja meg a tároló nevét mycontainer és a Blob előtagot vd1/vd2.

BlobPrefix - Blobelőtag
string. Választható. Használja a következőt: Destination = AzureBlob.

Adja meg a fájlok szűréséhez használható előtagot.

Példa: Összefűzhet egy buildszámot, hogy az azonos buildszámmal rendelkező összes blob fájljait szűrje.

Példa: Ha megad egy Blob-előtagot myvd1, a tárolóban létrejön egy virtuális könyvtár. A fájlokat a rendszer a forrásból a következőbe másolja: https://myaccount.blob.core.windows.net/mycontainer/myvd1/.

cloudService - Felhőszolgáltatás
Bemeneti alias: EnvironmentName. string. Akkor szükséges, ha ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs.

Adja meg a cél felhőszolgáltatás nevét.

resourceGroup - Erőforráscsoport
Bemeneti alias: EnvironmentNameRM. string. Akkor szükséges, ha ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs.

Adja meg a cél erőforráscsoport nevét.

ResourceFilteringMethod - Gépek kiválasztása a következő szerint:
string. Választható. Használja a következőt: Destination = AzureVMs. Engedélyezett értékek: machineNames (Gépnevek), tags. Alapértelmezett érték: machineNames.

Adja meg a virtuálisgép-gazdagép nevét vagy címkéjét, amely egy erőforráscsoportban lévő virtuális gépek egy részét azonosítja. A címkék csak az Azure Resource Manager keresztül létrehozott erőforrások esetében támogatottak.

MachineNames - Szűrési feltételek
string. Választható. Használja a következőt: Destination = AzureVMs.

Adja meg az Azure-beli virtuális gépek gazdagépneveinek listáját, például ffweb, vagy címkéket, például Role:DB, , WebOS:Win8.1. ffdb

Megjegyzés: A címkék érvényes határolójele a következő: ,(vessző), :(colon) és ;(semicolon). Ha több címkét ad meg, a feladat a megadott címkéket tartalmazó összes virtuális gépen futni fog. Alapértelmezés szerint a feladat az összes virtuális gépen fut.

vmsAdminUserName - Rendszergazda bejelentkezés
string. Akkor szükséges, ha Destination = AzureVMs.

Adja meg az Azure-beli virtuális gép rendszergazdai fiókjának felhasználónevét.

vmsAdminPassword - Jelszó
string. Akkor szükséges, ha Destination = AzureVMs.

Adja meg az Azure-beli virtuális gép rendszergazdai fiókjának jelszavát.

Az érvényes bemenet tartalmazza a buildelési vagy kiadási folyamatokban definiált változókat, például $(passwordVariable)a következőt: . A jelszó biztonságossá tételéhez jelölje meg secret.

TargetPath - Célmappát
string. Akkor szükséges, ha Destination = AzureVMs.

Adja meg a cél virtuális gépek helyi elérési útját.

Az érvényes bemenet olyan környezeti változókat tartalmaz, mint a $env:windir\BudgetIT\Web.

AdditionalArgumentsForBlobCopy - Nem kötelező argumentumok (fájlok blobba való feltöltéséhez)
string.

Adjon meg további argumentumokat AzCopy.exe , amelyek a blobokra való feltöltéskor alkalmazhatók, például /NC:10: .

Ha nincs megadva választható argumentum, a rendszer alapértelmezés szerint az alábbi argumentumokat adja hozzá.

• /Y
• /SetContentType
• /Z
• /V
• /S – Akkor van hozzáadva, ha a tároló neve nem $root.
• /BlobType:page – Akkor lesz hozzáadva, ha a megadott tárfiók prémium szintű fiók.
• /Pattern – Akkor lesz hozzáadva, ha a forrás elérési útja fájl. A többi megadott választható argumentum része.

AdditionalArgumentsForVMCopy - Választható argumentumok (fájlok virtuális gépre való letöltéséhez)
string. Választható. Használja a következőt: Destination = AzureVMs.

Adjon meg további argumentumokat AzCopy.exe , amelyek a virtuális gépekre való letöltéskor alkalmazhatók, például /NC:10: .

Ha nincs megadva választható argumentum, a rendszer alapértelmezés szerint hozzáadja az alábbiakat.

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

enableCopyPrerequisites - Másolási előfeltételek engedélyezése
boolean. Választható. Használja a következőt: ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Alapértelmezett érték: false.

Ha engedélyezve van, önaláírt tanúsítvánnyal konfigurálja a Windows Remote Management (WinRM) figyelőt az 5986-os porton a HTTPS protokoll helyett. Másolási műveletek azure-beli virtuális gépeken való végrehajtásához szükséges. Ha a cél virtuális gépek terheléselosztót használnak, konfiguráljon bejövő NAT-szabályokat a célporthoz (5986). Csak ARM-alapú virtuális gépekre vonatkozik.

CopyFilesInParallel - Másolás párhuzamosan
boolean. Választható. Használja a következőt: Destination = AzureVMs. Alapértelmezett érték: true.

Az alapértelmezett beállítás elfogadása a cél virtuális gépekkel párhuzamosan másolja a fájlokat.

CleanTargetBeforeCopy - Tiszta cél
boolean. Választható. Használja a következőt: Destination = AzureVMs. Alapértelmezett érték: false.

Ennek az értéknek a beállításával true törli a célmappát a másolási művelet végrehajtása előtt.

skipCACheck - Tanúsítvány tesztelése
boolean. Választható. Használja a következőt: Destination = AzureVMs. Alapértelmezett érték: true.

Az alapértelmezett érték nem ellenőrzi, hogy a kiszolgálótanúsítványt egy megbízható hitelesítésszolgáltató írta-e alá, mielőtt HTTPS-kapcsolaton keresztül csatlakozik.

outputStorageUri - Tároló URI-ja
string.

Adja meg annak a tárolónak az URI-jának a nevét, amelybe a fájlokat másolta. Csak akkor érvényes, ha a kiválasztott cél egy Azure-blob.

outputStorageContainerSasToken - Tároló SAS-jogkivonata
string.

Adja meg a tároló SAS-jogkivonatához használt változó nevét, amely hozzáfér a másolt fájlokhoz. Csak akkor érvényes, ha a kiválasztott cél egy Azure-blob.

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

A 2.0-s verzió újdonságai: Az AzCopy újabb verziójának használata.

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás:	Ügynök, DeploymentGroup
Igények	A saját üzemeltetésű ügynököknek olyan képességekkel kell rendelkezniük , amelyek megfelelnek az alábbi követelményeknek a feladatot használó feladatok futtatásához: azureps
Képességek	Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Bármelyik
Változók beállítása	Bármelyik
Ügynök verziója	1.103.0 vagy újabb
Feladatkategória	Üzembe helyezés