AzureFileCopy@1 - Azure ファイル コピー v1 タスク

ファイルをAzure Blob Storageまたは仮想マシンにコピーします。

注意

このタスクでは、ワークフロー ID フェデレーションを使用した Azure Resource Manager認証はサポートされていません。

構文

# Azure file copy v1
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@1
  inputs:
    SourcePath: # string. Required. Source. 
    #azureConnectionType: 'ConnectedServiceNameARM' # 'ConnectedServiceName' | 'ConnectedServiceNameARM'. Alias: ConnectedServiceNameSelector. Azure Connection Type. Default: ConnectedServiceNameARM.
    #azureClassicSubscription: # string. Alias: ConnectedServiceName. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Classic Subscription. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. Azure Subscription. 
    Destination: # 'AzureBlob' | 'AzureVMs'. Required. Destination Type. 
    #classicStorage: # string. Alias: StorageAccount. Required when ConnectedServiceNameSelector = ConnectedServiceName. Classic Storage Account. 
    storage: # string. Alias: StorageAccountRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM. RM Storage Account. 
    #ContainerName: # string. Required when Destination = AzureBlob. Container Name. 
    #BlobPrefix: # string. Optional. Use when Destination = AzureBlob. Blob Prefix. 
    #cloudService: # string. Alias: EnvironmentName. Required when ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs. Cloud Service. 
    #resourceGroup: # string. Alias: EnvironmentNameRM. Required when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Resource Group. 
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Optional. Use when Destination = AzureVMs. Select Machines By. Default: machineNames.
    #MachineNames: # string. Optional. Use when Destination = AzureVMs. Filter Criteria. 
    #vmsAdminUserName: # string. Required when Destination = AzureVMs. Admin Login. 
    #vmsAdminPassword: # string. Required when Destination = AzureVMs. Password. 
    #TargetPath: # string. Required when Destination = AzureVMs. Destination Folder. 
    #AdditionalArguments: # string. Additional Arguments. 
    #enableCopyPrerequisites: false # boolean. Optional. Use when ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs. Enable Copy Prerequisites. Default: false.
    #CopyFilesInParallel: true # boolean. Optional. Use when Destination = AzureVMs. Copy in Parallel. Default: true.
    #CleanTargetBeforeCopy: false # boolean. Optional. Use when Destination = AzureVMs. Clean Target. Default: false.
    #skipCACheck: true # boolean. Optional. Use when Destination = AzureVMs. Test Certificate. Default: true.
  # Output
    #outputStorageUri: # string. Storage Container URI. 
    #outputStorageContainerSasToken: # string. Storage Container SAS Token.

入力

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

ソース フォルダー、ローカル コンピューター上のファイル、または UNC 共有の絶対パスを指定します。 指定した値または式は、単一のフォルダー名またはファイル名を返す必要があります。

azureConnectionType - Azure 接続の種類
入力エイリアス: ConnectedServiceNameSelector。 string. 使用できる値: ConnectedServiceName (Azure クラシック)、 ConnectedServiceNameARM (Azure Resource Manager)。 既定値: ConnectedServiceNameARM。

Azure 接続の種類を指定します。

azureClassicSubscription - Azure クラシック サブスクリプション
入力エイリアス: ConnectedServiceName。 string. ConnectedServiceNameSelector = ConnectedServiceName の場合に必要です。

ターゲットの Azure クラシック サブスクリプションを指定します。

azureSubscription - Azure サブスクリプション
入力エイリアス: ConnectedServiceNameARM。 string. ConnectedServiceNameSelector = ConnectedServiceNameARM の場合に必要です。

ターゲットの Azure Resource Manager サブスクリプションを指定します。

Destination - 送信先の種類
string. 必須です。 使用できる値: AzureBlob (Azure BLOB) AzureVMs 、(Azure VM)。

ファイルのコピーに使用するコピー先の種類を指定します。

classicStorage - クラシック ストレージ アカウント
入力エイリアス: StorageAccount。 string. ConnectedServiceNameSelector = ConnectedServiceName の場合に必要です。

既存のクラシック ストレージ アカウントを指定します。 これは、Azure VM にファイルをコピーするための仲介役として使用されるストレージ アカウントです。

storage - RM ストレージ アカウント
入力エイリアス: StorageAccountRM。 string. ConnectedServiceNameSelector = ConnectedServiceNameARM の場合に必要です。

既存の ARM ストレージ アカウントを指定します。 これは、Azure VM にファイルをコピーするための仲介役として使用されるストレージ アカウントです。

ContainerName - コンテナー名
string. Destination = AzureBlob の場合に必要です。

ファイルをコピーするコンテナーの名前を指定します。 指定したコンテナーがストレージ アカウントに存在しない場合は、作成されます。

コンテナー内に仮想ディレクトリを作成するには、BLOB プレフィックス入力を使用します。

例: ターゲットの場所https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/には、コンテナー名mycontainerと BLOB プレフィックスを指定します。 vd1/vd2

BlobPrefix - BLOB プレフィックス
string. 省略可能。 の場合は Destination = AzureBlobを使用します。

ファイルのフィルター処理に使用できるプレフィックスを指定します。

例: ビルド番号を追加して、同じビルド番号を持つすべての BLOB のファイルをフィルター処理できます。

例: BLOB プレフィックス myvd1を指定すると、コンテナー内に仮想ディレクトリが作成されます。 ファイルは、ソースから に https://myaccount.blob.core.windows.net/mycontainer/myvd1/コピーされます。

cloudService - クラウド サービス
入力エイリアス: EnvironmentName。 string. ConnectedServiceNameSelector = ConnectedServiceName && Destination = AzureVMs の場合に必要です。

ターゲット クラウド サービスの名前を指定します。

resourceGroup - リソース グループ
入力エイリアス: EnvironmentNameRM。 string. ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMs の場合に必要です。

ターゲット リソース グループの名前を指定します。

ResourceFilteringMethod - 以下の条件でコンピューターを選択
string. 省略可能。 の場合は Destination = AzureVMsを使用します。 使用できる値: machineNames (マシン名)、 tags。 既定値: machineNames。

リソース グループ内の VM のサブセットを識別する VM ホスト名またはタグを指定します。 タグは、Azure Resource Manager経由で作成されたリソースでのみサポートされます。

MachineNames - フィルター条件
string. 省略可能。 の場合は Destination = AzureVMsを使用します。

、 などのタグRole:DBなどの ffdbffwebAzure VM ホスト名の一覧をWebOS:Win8.1指定します。

注: タグの有効な区切り記号には、,(コンマ)、:(colon)、;(semicolon) があります。 複数のタグを指定すると、タスクは指定されたタグを含む VM でのみ実行されます。 既定では、タスクはすべての VM で実行されます。

vmsAdminUserName - 管理者ログイン
string. Destination = AzureVMs の場合に必要です。

Azure VM 管理者アカウントのユーザー名を指定します。

vmsAdminPassword - パスワード
string. Destination = AzureVMs の場合に必要です。

Azure VM 管理者アカウントのパスワードを指定します。

有効な入力には、 などの $(passwordVariable)ビルドパイプラインまたはリリース パイプラインで定義された変数が含まれます。 パスワードをセキュリティで保護するには、 として secretマークします。

TargetPath - ターゲット フォルダー
string. Destination = AzureVMs の場合に必要です。

ソースからファイルをコピーするためのターゲット VM のローカル パスを指定します。

有効な入力には、 などの環境変数が $env:windir\BudgetIT\Web含まれます。

AdditionalArguments - その他の引数
string.

BLOB または VM ( など/NC:10) にAzCopy.exeアップロードするときに適用される に追加の引数を指定します。

enableCopyPrerequisites - コピーの前提条件を有効にする
boolean. 省略可能。 の場合は ConnectedServiceNameSelector = ConnectedServiceNameARM && Destination = AzureVMsを使用します。 既定値: false。

有効にすると、自己署名証明書を使用して、HTTPS プロトコルではなくポート 5986 で Windows リモート管理 (WinRM) リスナーを構成します。 Azure VM でコピー操作を実行するために必要です。 ターゲット VM でロード バランサーを使用する場合は、ターゲット ポート (5986) の受信 NAT 規則を構成します。 ARM VM にのみ適用されます。

CopyFilesInParallel - 並列でのコピー
boolean. 省略可能。 の場合は Destination = AzureVMsを使用します。 既定値: true。

既定の設定を受け入れると、ターゲット VM に並列でファイルがコピーされます。

CleanTargetBeforeCopy - ターゲットをクリーンにする
boolean. 省略可能。 の場合は Destination = AzureVMsを使用します。 既定値: false。

コピー操作を実行する true 前に、コピー先フォルダーをクリーンアップするように 設定します。

skipCACheck - テスト証明書
boolean. 省略可能。 の場合は Destination = AzureVMsを使用します。 既定値: true。

HTTPS 経由で接続する前に、サーバー証明書が信頼された CA によって署名されたかどうかは、既定値では検証されません。

outputStorageUri - ストレージ コンテナー URI
string.

ファイルのコピー先のストレージ コンテナー URI に使用される変数の名前を指定します。 選択した宛先が Azure BLOB の場合にのみ有効です。

outputStorageContainerSasToken - ストレージ コンテナー SAS トークン
string.

コピーされたファイルにアクセスするストレージ コンテナー SAS トークンに使用される変数の名前を指定します。 選択した宛先が Azure BLOB の場合にのみ有効です。

タスク制御オプション

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

出力変数

[なし] :

必要条件

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