WindowsMachineFileCopy@1 - Windows マシン ファイルのコピー v1 タスク

  • [アーティクル]

このタスクを使用して、リモート Windows マシンにファイルをコピーします。

構文

# Windows machine file copy v1
# Copy files to remote Windows machines.
- task: WindowsMachineFileCopy@1
  inputs:
    SourcePath: # string. Required. Source. 
    #EnvironmentName: # 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. 
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineNames: # string. Filter Criteria.

# Windows Machine File Copy v1
# Copy files to remote machine(s).
- task: WindowsMachineFileCopy@1
  inputs:
    SourcePath: # string. Required. Source. 
    #EnvironmentName: # 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. 
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineNames: # string. Filter Criteria.

入力

SourcePath - ソース
string. 必須です。

ローカル コンピューターまたは UNC 共有上のソース フォルダーまたはファイルの絶対パスを指定します (例: c:\fabrikamfiber または \\fabrikamshare\fabrikamfiber)。


EnvironmentName - マシン
string.

マシンの IP アドレスまたは FQDN のコンマ区切りの一覧 (例: dbserver.fabrikam.com,192.168.12.34) を指定します。 他のタスクの出力変数 (例: $(variableName)) を指定することもできます。


AdminUserName - 管理者ログイン
string.

ターゲット マシンの管理者ログインを指定します。


AdminPassword - パスワード
string.

ターゲット マシンの管理者ログインのパスワードを指定します。 としてビルド/リリース定義で定義 $(passwordVariable) された変数が受け入れられます。 変数の型を として secret マークして、セキュリティで保護することができます。


TargetPath - ターゲット フォルダー
string. 必須です。

ターゲット コンピューター上のローカル パス、または または などのd:\fabrikam\\fabrikam\Webソースからファイルをコピーするためのアクセス可能な UNC パスを指定します。


CleanTargetBeforeCopy - ターゲットをクリーンにする
boolean. 既定値: false。

ファイルをコピーする前に、コピー先フォルダーをクリーンアップします。


CopyFilesInParallel - 並列でファイルをコピーする
boolean. 既定値: true。

マシンに並列でファイルをコピーします。


AdditionalArguments - その他の引数
string.

ファイルのコピー時に適用される追加の robocopy 引数を指定します (例: /min:33553332 /l)。


ResourceFilteringMethod - 以下の条件でコンピューターを選択
string. 使用できる値: machineNames (マシン名)、 tags。 既定値: machineNames。


MachineNames - フィルター条件
string.

この入力はマシン グループに対してのみ有効であり、マシンまたは出力変数のフラット リストではまだサポートされていません。

など、または タグなどの dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34マシンのコンマ区切りの一覧を Role:DB; OS:Win8.1指定します。 複数のタグが指定されている場合、タスクは指定されたタグを持つすべてのマシンで実行されます。 既定では、すべてのマシンでタスクが実行されます。


タスク制御オプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

必要条件

要件 説明
パイプラインの種類 YAML、クラシック ビルド、クラシック リリース
上で実行 エージェント、DeploymentGroup
確認要求 なし
Capabilities このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 Any
設定可能な変数 Any
エージェントのバージョン 1.104.0 以上
タスクのカテゴリ 配置