このタスクを使用して、リモートの Windows マシンにファイルをコピーします。
構文
# 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.
入力
SourcePath
-
ソース
string
。 必須。
コピーするファイルへのパス。
c:\fabrikamfiber
や \\fabrikamshare\fabrikamfiber
など、ローカル コンピューターまたは UNC 共有上のソース フォルダーまたはファイルの絶対パスを指定します。
$(Build.Repository.LocalPath)
(エージェント・コンピューター上の作業フォルダー) などの事前定義システム変数を使用すると、自動化エージェントをホストするコンピューター上のビルド成果物の場所を簡単に指定できます。
MachineNames
-
マシン
string
。 必須。
マシンの IP アドレスまたは FQDN のコンマ区切りリストを指定します (オプションでポート番号を含めます)。
たとえば、 dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34
他のタスク ( $(variableName)
など) の出力変数を指定したり、 Azure リソース グループの名前を使用したりすることもできます。
MachineNames
-
マシン
string
。
マシンの IP アドレスまたは FQDN のコンマ区切りリストを指定します (オプションでポート番号を含めます)。 たとえば、 dbserver.fabrikam.com, dbserver_int.fabrikam.com:5986, 192.168.12.34
と指定します。 また、他のタスクの出力変数 ( $(variableName)
など) を指定したり、 Azure リソース グループの名前を使用したりすることもできます。
AdminUserName
-
管理者ログイン
string
。 必須。
ターゲット ホスト上のドメインまたはローカル管理アカウントのユーザー名を指定します。
___domain\username、username、machine-name\username などの形式がサポートされています。 UPN 形式 ( username@___domain.com
など) と、組み込みのシステム アカウント ( NT Authority\System など) はサポートされていません。
AdminUserName
-
管理者ログイン
string
。
ターゲット ホスト上のドメインまたはローカル管理アカウントのユーザー名を指定します。
___domain\username、username、machine-name\username などの形式がサポートされています。 UPN 形式 ( username@___domain.com
など) と、組み込みのシステム アカウント ( NT Authority\System など) はサポートされていません。
AdminPassword
-
パスワード
string
。 必須。
ターゲット マシンの管理者ログインのパスワードを指定します。 ビルド パイプラインまたはリリース パイプラインで定義されている変数 ( $(passwordVariable)
など) は受け入れられます。 変数を secret
としてマークして、変数を保護できます。
AdminPassword
-
パスワード
string
。
ターゲット マシンの管理者ログインのパスワードを指定します。 ビルド パイプラインまたはリリース パイプラインで定義されている変数 ( $(passwordVariable)
など) は受け入れられます。 変数を secret
としてマークして、変数を保護できます。
宛先フォルダーのを TargetPath
- する
string
。 必須。
ターゲット マシン上のローカル パス、またはソースからファイルをコピーするためのアクセス可能な UNC パス ( d:\fabrikam
や \\fabrikam\Web
など) を指定します。
クリーン ターゲットの CleanTargetBeforeCopy
-
boolean
。 既定値: false
。
新しいファイルをコピーする前に、ターゲット フォルダー内のすべてのファイルを削除します。
CopyFilesInParallel
-
並列 でファイルをコピーする
boolean
。 既定値: true
。
すべてのターゲットマシンにファイルを並行してコピーするため、コピープロセスを高速化できます。
AdditionalArguments
-
追加の引数
string
。
ファイルをコピーするときに適用される追加の RoboCopy 引数 ( /min:33553332 /l
など) を指定します。
タスク制御オプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
なし。
注釈
このタスクを使用して、Windows マシンにアプリケーションをインストールするために必要なアプリケーション ファイルやその他の成果物 (PowerShell スクリプトや PowerShell-DSC モジュールなど) をコピーします。 これは、データの高速コピーのために構築されたコマンドラインユーティリティであるRoboCopyを使用します。
このタスクを使用すると、システムエラー53が発生するのはなぜですか?
通常、これは指定したパスが見つからない場合に発生します。 これは、ファイアウォールがファイルとプリンターの共有に必要なポートをブロックしているか、パスの指定が無効であることが原因である可能性があります。 詳細については、TechNet の エラー 53 を参照してください。
バージョン 2.0 の新機能
- プロキシのサポートが追加されています。
- 従来の DTL マシンのサポートが削除されました。