Dela via


WindowsMachineFileCopy@2 – Uppgift för kopiering av Windows-datorfil v2

Använd den här uppgiften för att kopiera filer till fjärranslutna Windows-datorer.

Syntax

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

Ingångar

SourcePath - Källa
string. Obligatoriskt.

Sökvägen till de filer som ska kopieras. Anger den absoluta sökvägen för källmappen eller filen på den lokala datorn eller en UNC-resurs, till exempel c:\fabrikamfiber eller \\fabrikamshare\fabrikamfiber. Du kan använda fördefinierade systemvariabler, till $(Build.Repository.LocalPath) exempel (arbetsmappen på agentdatorn), vilket gör det enkelt att ange platsen för byggartefakterna på den dator som är värd för automationsagenten.


MachineNames - Maskiner
string. Obligatoriskt.

Anger en kommaavgränsad lista över datorns IP-adresser eller FQDN:er, eventuellt inklusive portnumret.
Till exempel: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34 Du kan också ange utdatavariabeln för andra uppgifter, till exempel $(variableName), eller så kan du använda namnet på en Azure-resursgrupp.


MachineNames - Maskiner
string.

Anger en kommaavgränsad lista över datorns IP-adresser eller FQDN:er, eventuellt inklusive portnumret. Till exempel: dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34. Du kan också ange utdatavariabeln för andra uppgifter, till exempel $(variableName), eller så kan du använda namnet på en Azure-resursgrupp.


AdminUserName - Administratörsinloggning
string. Obligatoriskt.

Anger användarnamnet för en domän eller ett lokalt administrativt konto på målvärdarna. Format som domän\användarnamn, användarnamn och datornamn\användarnamn stöds. UPN-format, till username@domain.comexempel , och inbyggda systemkonton, till exempel NT Authority\System, stöds inte.


AdminUserName - Administratörsinloggning
string.

Anger användarnamnet för en domän eller ett lokalt administrativt konto på målvärdarna. Format som domän\användarnamn, användarnamn och datornamn\användarnamn stöds. UPN-format, till username@domain.comexempel , och inbyggda systemkonton, till exempel NT Authority\System, stöds inte.


AdminPassword - Lösenord
string. Obligatoriskt.

Anger lösenordet för administratörsinloggningen för måldatorerna. Variabler som definieras i bygg- eller versionspipelines, till $(passwordVariable)exempel , accepteras. Du kan markera variabeln för secret att säkra den.


AdminPassword - Lösenord
string.

Anger lösenordet för administratörsinloggningen för måldatorerna. Variabler som definieras i bygg- eller versionspipelines, till $(passwordVariable)exempel , accepteras. Du kan markera variabeln för secret att säkra den.


TargetPath - målmapp
string. Obligatoriskt.

Anger den lokala sökvägen på måldatorerna eller en tillgänglig UNC-sökväg för att kopiera filerna från källan, t.ex d:\fabrikam\\fabrikam\Web.


CleanTargetBeforeCopy - Rensa mål
boolean. Standardvärde: false.

Tar bort alla filer i målmappen innan de nya filerna kopieras till den.


CopyFilesInParallel - kopiera filer parallellt
boolean. Standardvärde: true.

Kopierar filer till alla måldatorer parallellt, vilket kan påskynda kopieringsprocessen.


AdditionalArguments - Ytterligare argument
string.

Anger ytterligare RoboCopy-argument som används vid kopiering av filer, t.ex /min:33553332 /l.


Alternativ för uppgiftskontroll

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Anmärkningar

Använd den här uppgiften för att kopiera programfiler och andra artefakter, till exempel PowerShell-skript och PowerShell-DSC-moduler, som krävs för att installera programmet på Windows-datorer. Den använder RoboCopy, kommandoradsverktyget som är byggt för snabb kopiering av data.

Varför får jag ett systemfel 53 när jag använder den här uppgiften?

Vanligtvis inträffar detta när den angivna sökvägen inte kan hittas. Detta kan bero på att en brandvägg blockerar de portar som krävs för fil- och skrivardelning eller en ogiltig sökvägsspecifikation. Mer information finns i Fel 53 på TechNet.

Nyheter i version 2.0

  • Stöd för proxy läggs till.
  • Stöd för äldre DTL-datorer har tagits bort.

Kravspecifikation

Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
Krav Ingen
Kapaciteter Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar Vilken som helst
variabler som kan Vilken som helst
Agentversion 1.104.0 eller senare
Aktivitetskategori Rulla ut