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

Artykuł
07/02/2024

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.

# Windows Machine File Copy v2
# Copy files to remote machine(s).
- 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

SourcePath - Źródła
string. 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żyć 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 hostujących agenta automatyzacji.

MachineNames - Maszyny
string. Wymagane.

Określa rozdzielaną przecinkami listę adresów IP maszyny lub nazw FQDN, opcjonalnie łącznie 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 maszyny lub nazw FQDN, opcjonalnie łącznie 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.

AdminUserName - logowanie Administracja
string. Wymagane.

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

AdminUserName - logowanie Administracja
string.

AdminPassword - Hasło
string. 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ć.

AdminPassword - Hasło
string.

TargetPath - Folder docelowy
string. Wymagane.

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

CleanTargetBeforeCopy - Czysty obiekt docelowy
boolean. Wartość domyślna: false.

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

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

Kopiuje pliki do wszystkich maszyn docelowych równolegle, co może przyspieszyć proces kopiowania.

AdditionalArguments - Dodatkowe argumenty
string.

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

Opcje sterowania zadaniami

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

Zmienne wyjściowe

Brak.

Uwagi

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

Dlaczego podczas korzystania z tego zadania występuje błąd systemowy 53?

Zazwyczaj dzieje się tak, gdy nie można znaleźć określonej ścieżki. Może to być spowodowane blokowaniem przez zaporę niezbędnych portów do udostępniania plików i drukarek lub nieprawidłowej specyfikacji ścieżki. Aby uzyskać więcej informacji, zobacz Błąd 53 w witrynie TechNet.

Co nowego w wersji 2.0

Jest dodawana obsługa serwera proxy.
Usunięto obsługę starszych maszyn DTL.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, kompilacja klasyczna, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Brak
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne w formie tabeli settable	Dowolne
Wersja agenta	1.104.0 lub nowsza
Kategoria zadania	Wdrażanie

Udostępnij za pośrednictwem