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

Artykuł
03/24/2025

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

To zadanie zostało uznane za przestarzałe, ponieważ ta wersja zadania AzureFileCopy używa wycofanej wersji narzędzia AzCopy. Użyj najnowszej wersji zadania AzureFileCopy. Zobacz Przewodnik migracji narzędzia AzCopy dla wersji 8 do 10.

Uwaga

To zadanie nie obsługuje uwierzytelniania przy użyciu usługi Azure Resource Manager z federacją tożsamości przepływu pracy.

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

Uwaga

To zadanie nie obsługuje uwierzytelniania przy użyciu usługi Azure Resource Manager z federacją tożsamości przepływu pracy.

Składnia

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

Dane wejściowe

źródła SourcePath -
string. To jest wymagane.

Określ ścieżkę bezwzględną folderu źródłowego, pliku na komputerze lokalnym lub udziału UNC. Określona wartość lub wyrażenie powinny zwracać 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 - klasycznej subskrypcji platformy Azure
Alias wejściowy: ConnectedServiceName. string. Wymagane, gdy ConnectedServiceNameSelector = ConnectedServiceName.

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

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

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

Destination - typ docelowy
string. To jest wymagane. Dozwolone wartości: AzureBlob (Azure Blob), AzureVMs (maszyny wirtualne platformy Azure).

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

klasycznego konta magazynu classicStorage -
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 - konta magazynu usługi RM
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.

Przykład: w przypadku lokalizacji docelowej https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/określ nazwę kontenera mycontainer i prefiks obiektu blob: vd1/vd2.

prefiks BlobPrefix - 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 obiektu blob myvd1, katalog wirtualny zostanie utworzony wewnątrz kontenera. Pliki są kopiowane ze źródła do https://myaccount.blob.core.windows.net/mycontainer/myvd1/.

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

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

resourceGroup - grupy 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 ffweb, ffdblub tagi, takie jak Role:DB, Web, OS:Win8.1.

Uwaga: prawidłowe ograniczniki dla tagów to ,(przecinek), :(colon) i ;(semicolon). W przypadku podawania wielu tagów zadanie będzie uruchamiane tylko na maszynach wirtualnych, które zawierają określone tagi. Domyślnie zadanie jest uruchamiane na wszystkich maszynach wirtualnych.

logowania administratora vmsAdminUserName -
string. Wymagane, gdy Destination = AzureVMs.

Określ nazwę użytkownika konta administratora maszyny wirtualnej platformy Azure.

haseł vmsAdminPassword -
string. Wymagane, gdy Destination = AzureVMs.

Określ hasło dla konta administratora maszyny wirtualnej platformy Azure.

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

folderu docelowego TargetPath -
string. Wymagane, gdy Destination = AzureVMs.

Określ ścieżkę lokalną na docelowych maszynach wirtualnych do kopiowania plików ze źródła.

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

AdditionalArguments - dodatkowych argumentów
string.

Podaj dodatkowe argumenty do AzCopy.exe, które będą stosowane podczas przekazywania do obiektów blob lub maszyn wirtualnych, takich jak /NC:10.

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żyje 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 równoległych
boolean. Opcjonalny. Użyj polecenia , gdy Destination = AzureVMs. Wartość domyślna: true.

Akceptowanie domyślnego ustawienia kopiuje pliki równolegle do docelowych maszyn wirtualnych.

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

Ustawienie true czyści folder docelowy przed wykonaniem akcji kopiowania.

skipCACheck - certyfikatu testowego
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.

tokenu SAS kontenera magazynu outputStorageContainerSasToken -
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 zadaniami

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

Zmienne wyjściowe

Żaden.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami do 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ń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	1.103.0 lub nowsza
Kategoria zadań	Wdroż

Udostępnij za pośrednictwem