AzureFileCopy@4 - Azure ファイル コピー v4 タスク

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

# Azure file copy v4
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@4
  inputs:
    SourcePath: # string. Required. Source. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required. Azure Subscription. 
    Destination: # 'AzureBlob' | 'AzureVMs'. Required. Destination Type. 
    storage: # string. Alias: StorageAccountRM. Required. RM Storage Account. 
    #ContainerName: # string. Required when Destination = AzureBlob. Container Name. 
    #BlobPrefix: # string. Optional. Use when Destination = AzureBlob. Blob Prefix. 
    #resourceGroup: # string. Alias: EnvironmentNameRM. Required when 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. 
    #AdditionalArgumentsForBlobCopy: # string. Optional Arguments (for uploading files to blob). 
    #AdditionalArgumentsForVMCopy: # string. Optional. Use when Destination = AzureVMs. Optional Arguments (for downloading files to VM). 
    #sasTokenTimeOutInMinutes: '240' # string. Optional. Use when Destination = AzureBlob. SAS Token Expiration Period In Minutes. Default: 240.
    #enableCopyPrerequisites: false # boolean. Optional. Use when 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.

SourcePath - ソース
string。 必須。

ソース ファイルの場所。 サポートされている値には、YAML パイプラインとクラシック リリースのサポート 、定義済みのシステム変数 ( Build.Repository.LocalPath など) が含まれます。

リリース変数 は、クラシックリリースでのみサポートされます。 ワイルドカード記号 (*) は、ファイル・パスまたはファイル名の任意の場所でサポートされます。

Azure サブスクリプションの azureSubscription -
入力エイリアス: ConnectedServiceNameARM。 string。 必須。

ターゲットの Azure サービス、仮想マシン、またはストレージ アカウントが存在するサブスクリプション用に構成 Azure Resource Manager サービス接続の名前を指定します。 詳細については、Azure Resource Manager の概要 を参照してください。

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

変換先の種類を指定します。

RM ストレージ アカウントの storage -
入力エイリアス: StorageAccountRM。 string。 必須。

既存の 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 のファイルを同じビルド番号でフィルター処理できます。

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

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

ファイルのコピー先となるターゲット・リソース・グループの名前を指定します。

によるマシンの選択を ResourceFilteringMethod - する
string。 任意。 Destination = AzureVMsするときに使用します。 使用できる値: machineNames (コンピューター名)、tags。 既定値: machineNames。

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

フィルター条件の MachineNames -
string。 任意。 Destination = AzureVMsするときに使用します。

タスクの対象となる VM を識別する VM 名またはタグ名の一覧を指定します。 有効なフィルター条件には、次のものが含まれます。

• Azure リソース グループの名前。
• 前のタスクの出力変数。
• タグ名または VM 名のコンマ区切りの一覧。
• FQDN または IP アドレスのコンマ区切りの一覧を使用して VM 名を書式設定します。
• フィルターのタグ名を次のように書式設定 {TagName}:{Value} 例: Role:DB;OS:Win8.1

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

すべてのターゲット VM に対する管理アクセス許可を持つアカウントのユーザー名を指定します。

• サポートされている形式は、username、___domain\username、machine-name\username、および .\usernameです。
• username@___domain.com や NT Authority\System などの組み込みのシステム アカウントを含む UPN 形式はサポートされていません。

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

Admin Login パラメーターのパスワードを指定します。

変数を見つけるには、 Admin Login パラメーターを見つけます。 「 Variables 」タブで定義された変数の南京錠アイコンを選択して値を保護し、ここに変数名を挿入します。

宛先フォルダーのを TargetPath - する
string。 Destination = AzureVMsする場合に必要です。

ファイルのコピー先となる Azure VM 内のフォルダーへのパスを指定します。

$env:windir や $env:systemroot などの環境変数がサポートされています。 例: $env:windir\FabrikamFiber\Web、c:\FabrikamFiber

AdditionalArgumentsForBlobCopy - 省略可能な引数 (BLOB にファイルをアップロードする場合)
string。

BLOB へのアップロード時と VM へのダウンロード時に使用する追加の引数を AzCopy.exe に指定します。 詳細については 、「AzCopy の Command-Line ユーティリティを使用してデータを転送する 」を参照してください。

Azure ページ BLOB のみをサポートする Premium ストレージ アカウントの場合は、追加の引数として --blob-type=PageBlob を使用します。

デフォルトの引数には、 --log-level=INFO (デフォルト) と --recursive (コンテナ名が $rootでない場合) が含まれます。

AdditionalArgumentsForVMCopy - オプションの引数 (VM にファイルをダウンロードする場合)
string。 任意。 Destination = AzureVMsするときに使用します。

VM にダウンロードするときに適用される AzCopy.exe 追加の引数 ( --check-length=true など) を VM に指定します。

オプションの引数が指定されていない場合は、デフォルトで次のものが追加されます。

• --log-level=INFO
• --log-level=DEBUG (パイプラインがデバッグ モード セットで実行されている場合)
• --recursive

sasTokenTimeOutInMinutes - SAS トークンの有効期限 (分)
string。 任意。 Destination = AzureBlobするときに使用します。 既定値: 240。

コンテナの SAS トークンの有効期限が切れるまでの時間を分単位で指定します。 デフォルトでは、このトークンは 4 時間後に期限切れになります。

コピーの前提条件を有効にする enableCopyPrerequisites -
boolean。 任意。 Destination = AzureVMsするときに使用します。 既定値: false。

有効にすると、このオプションは自己署名証明書を使用して、ポート 5986 の HTTPS プロトコル経由で Windows リモート管理 (WinRM) リスナーを構成します。 この構成は、Azure VM でコピー操作を実行するために必要です。

• ターゲット VM がロード バランサーを介してアクセスされる場合は、ポート 5986 でのアクセスを許可する受信 NAT 規則を構成します。
• ターゲット VM がネットワーク セキュリティ グループ (NSG) に関連付けられている場合は、ポート 5986 でのアクセスを許可する受信セキュリティ規則を構成します。

並列でのコピーの CopyFilesInParallel -
boolean。 任意。 Destination = AzureVMsするときに使用します。 既定値: true。

ターゲット VM に並列でファイルをコピーする true を指定します。

クリーン ターゲットの CleanTargetBeforeCopy -
boolean。 任意。 Destination = AzureVMsするときに使用します。 既定値: false。

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

skipCACheck - テスト証明書の
boolean。 任意。 Destination = AzureVMsするときに使用します。 既定値: true。

WinRM では、中間ストレージ BLOB から Azure VM にファイルをコピーするときに、HTTPS 転送用の証明書が必要です。

自己署名証明書を使用する場合は、 true を指定して、プロセスが信頼できる CA で証明書を検証しないようにします。

このタスクでは、次の 出力変数を定義します。この変数は、ダウンストリームのステップ、ジョブ、およびステージで使用できます。

StorageContainerUri
ファイルのコピー先のコンテナの URI。 選択した宛先が Azure BLOB の場合にのみ有効です。

StorageContainerSasToken
SasToken は、ファイルのコピー先となったコンテナです。 選択した宛先が Azure BLOB の場合にのみ有効です。