Udostępnij za pośrednictwem

WindowsMachineFileCopy@2 — zadanie kopiowania plików na komputerze z systemem Windows w wersji 2

To zadanie służy do kopiowania plików na zdalne maszyny z systemem Windows.

Składnia

# Windows machine file copy v2
# Copy files to remote Windows machines.
- task: WindowsMachineFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    MachineNames: # string. Required. Machines. 
    AdminUserName: # string. Required. Admin Login. 
    AdminPassword: # string. Required. Password. 
    TargetPath: # string. Required. Destination Folder. 
  # Advanced Options
    #CleanTargetBeforeCopy: false # boolean. Clean Target. Default: false.
    #CopyFilesInParallel: true # boolean. Copy Files in Parallel. Default: true.
    #AdditionalArguments: # string. Additional Arguments.

# Windows machine file copy v2
# Copy files to remote Windows machines.
- task: WindowsMachineFileCopy@2
  inputs:
    SourcePath: # string. Required. Source. 
    #MachineNames: # string. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    TargetPath: # string. Required. Destination Folder. 
  # Advanced Options
    #CleanTargetBeforeCopy: false # boolean. Clean Target. Default: false.
    #CopyFilesInParallel: true # boolean. Copy Files in Parallel. Default: true.
    #AdditionalArguments: # string. Additional Arguments.

Dane wejściowe

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

Ścieżka do plików do skopiowania. Określa ścieżkę bezwzględną folderu źródłowego lub pliku na komputerze lokalnym lub udziale UNC, na przykład c:\fabrikamfiber lub \\fabrikamshare\fabrikamfiber. Można używać wstępnie zdefiniowanych zmiennych systemowych, takich jak $(Build.Repository.LocalPath) (folder roboczy na komputerze agenta), co ułatwia określenie lokalizacji artefaktów kompilacji na komputerze, który hostuje agenta automatyzacji.


MachineNames - Maszyny
string. To jest wymagane.

Określa rozdzielaną przecinkami listę adresów IP komputera lub nazw FQDN, opcjonalnie wraz z numerem portu.
Na przykład: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34 Możesz również określić zmienną wyjściową innych zadań, na przykład $(variableName), lub użyć nazwy grupy zasobów platformy Azure.


MachineNames - Maszyny
string.

Określa rozdzielaną przecinkami listę adresów IP komputera lub nazw FQDN, opcjonalnie wraz z numerem portu. Na przykład: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34. Możesz również określić zmienną wyjściową innych zadań, na przykład $(variableName), lub użyć nazwy grupy zasobów platformy Azure.


logowania administratora AdminUserName -
string. To jest wymagane.

Określa nazwę użytkownika domeny lub lokalnego konta administracyjnego na hostach docelowych. Obsługiwane są formaty, takie jak domena\nazwa_użytkownika, nazwa użytkownika i nazwa-maszyny\nazwa_użytkownika . Formaty nazw UPN, takie jak username@domain.com, i wbudowane konta systemowe, takie jak NT Authority\System, nie są obsługiwane.


logowania administratora AdminUserName -
string.

Określa nazwę użytkownika domeny lub lokalnego konta administracyjnego na hostach docelowych. Obsługiwane są formaty, takie jak domena\nazwa_użytkownika, nazwa użytkownika i nazwa-maszyny\nazwa_użytkownika . Formaty nazw UPN, takie jak username@domain.com, i wbudowane konta systemowe, takie jak NT Authority\System, nie są obsługiwane.


haseł AdminPassword -
string. To jest wymagane.

Określa hasło logowania administratora dla maszyn docelowych. Zmienne zdefiniowane w potokach kompilacji lub wydania, takie jak $(passwordVariable), są akceptowane. Możesz oznaczyć zmienną jako secret , aby ją zabezpieczyć.


haseł AdminPassword -
string.

Określa hasło logowania administratora dla maszyn docelowych. Zmienne zdefiniowane w potokach kompilacji lub wydania, takie jak $(passwordVariable), są akceptowane. Możesz oznaczyć zmienną jako secret , aby ją zabezpieczyć.


folderu docelowego TargetPath -
string. To jest wymagane.

Określa ścieżkę lokalną na maszynach docelowych lub dostępną ścieżkę UNC do kopiowania plików ze źródła, na przykład d:\fabrikam lub \\fabrikam\Web.


CleanTargetBeforeCopy - czysty cel
boolean. Wartość domyślna: false.

Usuwa wszystkie pliki w folderze docelowym przed skopiowaniem do niego nowych plików.


CopyFilesInParallel - kopiowania plików równolegle
boolean. Wartość domyślna: true.

Kopiuje pliki równolegle na wszystkie komputery docelowe, co może przyspieszyć proces kopiowania.


AdditionalArguments - dodatkowych argumentów
string.

Określa dodatkowe argumenty RoboCopy, które są stosowane podczas kopiowania plików, takie jak /min:33553332 /l.


Opcje sterowania zadania

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.

Uwagi

To zadanie służy do kopiowania plików aplikacji i innych artefaktów, takich jak skrypty programu PowerShell i moduły PowerShell-DSC, które są wymagane do zainstalowania aplikacji na maszynach z systemem Windows. Korzysta z RoboCopy, narzędzia wiersza poleceń stworzonego do szybkiego kopiowania danych.

Dlaczego podczas korzystania z tego zadania pojawia się błąd systemowy 53?

Zwykle dzieje się tak, gdy nie można zlokalizować określonej ścieżki. Może to być spowodowane zaporą blokującą niezbędne porty do udostępniania plików i drukarek lub nieprawidłową specyfikacją ścieżki. Aby uzyskać więcej informacji, zobacz Błąd 53 w witrynie TechNet.

Co nowego w wersji 2.0

  • Dodawana jest obsługa serwera proxy.
  • Usunięto obsługę starszych maszyn DTL.

Wymagania

Wymaganie Opis
Typy potoków YAML, klasyczna kompilacja, wersja klasyczna
Działa na Agent, DeploymentGroup
Wymagania Żaden
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.104.0 lub nowsza
Kategoria zadań Zainstaluj