WindowsMachineFileCopy@2 – Windows-dator, filkopiering v2-uppgift

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

Indata

SourcePath - Källkod
string. Krävs.

Sökvägen till filerna som ska kopieras. Anger den absoluta sökvägen till 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 exempel $(Build.Repository.LocalPath) (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. Krävs.

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


AdminUserName - Admin inloggning
string. Krävs.

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


AdminUserName - Admin inloggning
string.

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


AdminPassword - Lösenord
string. Krävs.

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


AdminPassword - Lösenord
string.

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


TargetPath - Målmappen
string. Krävs.

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, till exempel d:\fabrikam eller \\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 tillämpas vid kopiering av filer, till exempel /min:33553332 /l.


Alternativ för aktivitetskontroll

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

Utdatavariabler

Inga.

Kommentarer

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 skapats för snabb kopiering av data.

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

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

Nyheter i version 2.0

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

Krav

Krav Beskrivning
Pipelinetyper YAML, klassisk version, klassisk version
Körs på Agent, DeploymentGroup
Krav Ingen
Funktioner Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar Valfri
Inställningsbara variabler Valfri
Agentversion 1.104.0 eller senare
Uppgiftskategori Distribuera