AzureFileCopy@2 — zadanie kopiowania plików platformy Azure w wersji 2

Kopiowanie plików do Azure Blob Storage lub maszyn wirtualnych.

Uwaga

To zadanie nie obsługuje uwierzytelniania usługi Azure Resource Manager za pomocą federacji tożsamości przepływu pracy.

Składnia

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

Dane wejściowe

SourcePath - Źródła
string. Wymagane.

Określ ścieżkę bezwzględną do folderu źródłowego, pliku na komputerze lokalnym lub udziału UNC. Określona wartość lub wyrażenie powinno zwrócić pojedynczą nazwę folderu lub nazwę pliku.

azureConnectionType - Typ połączenia platformy Azure
Alias wejściowy: ConnectedServiceNameSelector. string. Dozwolone wartości: ConnectedServiceName (wersja klasyczna platformy Azure), ConnectedServiceNameARM (Azure Resource Manager). Wartość domyślna: ConnectedServiceNameARM.

Określ typ połączenia platformy Azure.

azureClassicSubscription - Klasyczna subskrypcja platformy Azure
Alias wejściowy: ConnectedServiceName. string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceName.

Określ docelową klasyczną subskrypcję platformy Azure.

azureSubscription - Subskrypcja platformy Azure
Alias wejściowy: ConnectedServiceNameARM. string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceNameARM.

Określ docelową subskrypcję usługi Azure Resource Manager.

Destination - Typ miejsca docelowego
string. Wymagane. Dozwolone wartości: AzureBlob (Azure Blob), AzureVMs (Maszyny wirtualne platformy Azure).

Określ typ miejsca docelowego, który ma być używany do kopiowania plików.

classicStorage - Klasyczne konto magazynu
Alias wejściowy: StorageAccount. string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceName.

Określ istniejące wcześniej klasyczne konto magazynu. Jest to konto magazynu używane jako pośrednik do kopiowania plików na maszyny wirtualne platformy Azure.

storage - Konto magazynu menedżera zasobów
Alias wejściowy: StorageAccountRM. string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceNameARM.

Określ istniejące wcześniej konto magazynu usługi ARM. Jest to konto magazynu używane jako pośrednik do kopiowania plików na maszyny wirtualne platformy Azure.

ContainerName - Nazwa kontenera
string. Wymagane, gdy Destination = AzureBlob.

Określ nazwę kontenera, do którego są kopiowane pliki. Jeśli określony kontener nie istnieje na koncie magazynu, zostanie utworzony.

Aby utworzyć katalog wirtualny wewnątrz kontenera, użyj danych wejściowych prefiksu obiektu blob. Na przykład w polu lokalizacja https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/docelowa określ nazwę mycontainer kontenera i prefiks vd1/vd2obiektu blob.

BlobPrefix - Prefiks obiektów blob
string. Opcjonalny. Użyj polecenia , gdy Destination = AzureBlob.

Określ prefiks, który może służyć do filtrowania plików.

Przykład: możesz dołączyć numer kompilacji, aby filtrować pliki ze wszystkich obiektów blob przy użyciu tego samego numeru kompilacji.

Przykład: Jeśli określisz prefiks myvd1obiektu blob, zostanie utworzony katalog wirtualny wewnątrz kontenera. Pliki są kopiowane ze źródła do .https://myaccount.blob.core.windows.net/mycontainer/myvd1/

cloudService - Usługa w chmurze
Alias wejściowy: EnvironmentName. string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs.

Określ nazwę docelowej usługi w chmurze.

resourceGroup - Grupa zasobów
Alias wejściowy: EnvironmentNameRM. string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs.

Określ nazwę docelowej grupy zasobów.

ResourceFilteringMethod - Wybierz maszyny według
string. Opcjonalny. Użyj polecenia , gdy Destination = AzureVMs. Dozwolone wartości: machineNames (nazwy maszyn), tags. Wartość domyślna: machineNames.

Określ nazwę lub tag hosta maszyny wirtualnej, który identyfikuje podzbiór maszyn wirtualnych w grupie zasobów. Tagi są obsługiwane tylko dla zasobów utworzonych za pośrednictwem usługi Azure Resource Manager.

MachineNames - Kryteria filtrowania
string. Opcjonalny. Użyj polecenia , gdy Destination = AzureVMs.

Podaj listę nazw hostów maszyn wirtualnych platformy Azure, takich jak , lub tagi, takie jak ffwebRole:DB, , Web. OS:Win8.1ffdb

Uwaga: prawidłowe ograniczniki tagów obejmują ,(przecinek), :(colon) i ;(semicolon). Podczas podawania wielu tagów zadanie zostanie uruchomione na wszystkich maszynach wirtualnych, które zawierają określone tagi. Domyślnie zadanie jest uruchamiane na wszystkich maszynach wirtualnych.

vmsAdminUserName - logowanie Administracja
string. Wymagane, gdy Destination = AzureVMs.

Podaj nazwę użytkownika konta administratora maszyny wirtualnej platformy Azure.

vmsAdminPassword - Hasło
string. Wymagane, gdy Destination = AzureVMs.

Podaj hasło dla konta administratora maszyny wirtualnej platformy Azure.

Prawidłowe dane wejściowe obejmują zmienne zdefiniowane w potokach kompilacji lub wydania, takich jak $(passwordVariable). Aby zabezpieczyć hasło, oznacz je jako secret.

TargetPath - Folder docelowy
string. Wymagane, gdy Destination = AzureVMs.

Określ ścieżkę lokalną na docelowych maszynach wirtualnych.

Prawidłowe dane wejściowe obejmują zmienne środowiskowe, takie jak $env:windir\BudgetIT\Web.

AdditionalArgumentsForBlobCopy - Opcjonalne argumenty (na potrzeby przekazywania plików do obiektu blob)
string.

Podaj dodatkowe argumenty AzCopy.exe , które można zastosować podczas przekazywania do obiektów blob, takich jak /NC:10.

Jeśli nie określono argumentów opcjonalnych, domyślnie dodawane są następujące argumenty.

• /Y
• /SetContentType
• /Z
• /V
• /S - Dodano, gdy nazwa kontenera nie $rootjest .
• /BlobType:page — Dodane, gdy określone konto magazynu jest kontem w warstwie Premium.
• /Pattern — Dodano, gdy ścieżka źródłowa jest plikiem. Dołączone do innych określonych argumentów opcjonalnych.

AdditionalArgumentsForVMCopy - Opcjonalne argumenty (do pobierania plików na maszynę wirtualną)
string. Opcjonalny. Użyj polecenia , gdy Destination = AzureVMs.

Podaj dodatkowe argumenty AzCopy.exe , które można zastosować podczas pobierania do maszyn wirtualnych, takich jak /NC:10.

Jeśli nie określono opcjonalnych argumentów, domyślnie są dodawane następujące elementy.

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

enableCopyPrerequisites - Włączanie wymagań wstępnych kopiowania
boolean. Opcjonalny. Użyj polecenia , gdy ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Wartość domyślna: false.

Po włączeniu użyj certyfikatu z podpisem własnym do skonfigurowania odbiornika zdalnego zarządzania systemem Windows (WinRM) na porcie 5986 zamiast protokołu HTTPS. Wymagane do wykonywania operacji kopiowania na maszynach wirtualnych platformy Azure. Jeśli docelowe maszyny wirtualne używają modułu równoważenia obciążenia, skonfiguruj reguły NAT dla portu docelowego (5986). Dotyczy tylko maszyn wirtualnych usługi ARM.

CopyFilesInParallel - Kopiowanie w sposób równoległy
boolean. Opcjonalny. Użyj polecenia , gdy Destination = AzureVMs. Wartość domyślna: true.

Zaakceptowanie ustawienia domyślnego powoduje równoległe skopiowanie plików do docelowych maszyn wirtualnych.

CleanTargetBeforeCopy - Wyczyść element docelowy
boolean. Opcjonalny. Użyj polecenia , gdy Destination = AzureVMs. Wartość domyślna: false.

Ustawienie tej wartości w celu true oczyszczenia folderu docelowego przed wykonaniem akcji kopiowania.

skipCACheck - Certyfikat testowy
boolean. Opcjonalny. Użyj polecenia , gdy Destination = AzureVMs. Wartość domyślna: true.

Wartość domyślna nie sprawdzi, czy certyfikat serwera został podpisany przez zaufany urząd certyfikacji przed nawiązaniem połączenia za pośrednictwem protokołu HTTPS.

outputStorageUri - Identyfikator URI kontenera magazynu
string.

Określ nazwę zmiennej używanej dla identyfikatora URI kontenera magazynu, do którego skopiowano pliki. Prawidłowe tylko wtedy, gdy wybrane miejsce docelowe jest obiektem blob platformy Azure.

outputStorageContainerSasToken - Token SAS kontenera magazynu
string.

Określ nazwę zmiennej używanej dla tokenu SAS kontenera magazynu, który uzyskuje dostęp do skopiowanych plików. Prawidłowe tylko wtedy, gdy wybrane miejsce docelowe jest obiektem blob platformy Azure.

Opcje sterowania zadania

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Uwagi

Co nowego w wersji 2.0: korzystanie z nowszej wersji narzędzia AzCopy.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa w	Agent, DeploymentGroup
Wymagania	Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami dotyczącymi uruchamiania zadań korzystających z tego zadania: azureps
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne ustawialne	Dowolne
Wersja agenta	1.103.0 lub nowsza
Kategoria zadania	Wdrażanie