Start-AzStorageBlobCopy

  • リファレンス
モジュール:
Az.Storage

BLOB のコピーを開始します。

構文

Start-AzStorageBlobCopy
     [-SrcBlob] <String>
     -SrcContainer <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageBlobCopy
     -CloudBlob <CloudBlob>
     [-BlobBaseClient <BlobBaseClient>]
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageBlobCopy
     -CloudBlob <CloudBlob>
     [-BlobBaseClient <BlobBaseClient>]
     -DestCloudBlob <CloudBlob>
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageBlobCopy
     -CloudBlobContainer <CloudBlobContainer>
     [-SrcBlob] <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageBlobCopy
     -SrcShareName <String>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageBlobCopy
     -SrcShare <CloudFileShare>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageBlobCopy
     -SrcDir <CloudFileDirectory>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageBlobCopy
     -SrcFile <CloudFile>
     -DestContainer <String>
     [-DestBlob <String>]
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageBlobCopy
     -SrcFile <CloudFile>
     -DestCloudBlob <CloudBlob>
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzStorageBlobCopy
     -AbsoluteUri <String>
     -DestContainer <String>
     -DestBlob <String>
     [-StandardBlobTier <String>]
     [-RehydratePriority <RehydratePriority>]
     [-Tag <Hashtable>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-DestTagCondition <String>]
     [-TagCondition <String>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

説明

Start-AzStorageBlobCopy コマンドレットは、BLOB のコピーを開始します。

例

例 1: 名前付き BLOB をコピーする

Start-AzStorageBlobCopy -SrcBlob "ContosoPlanning2015" -DestContainer "ContosoArchives" -SrcContainer "ContosoUploads"

このコマンドは、ContosoUploads という名前のコンテナーから ContosoArchives という名前のコンテナーへの ContosoPlanning2015 という名前の BLOB のコピー操作を開始します。

例 2: コピーする BLOB を指定するコンテナーを取得する

Get-AzStorageContainer -Name "ContosoUploads" | Start-AzStorageBlobCopy -SrcBlob "ContosoPlanning2015" -DestContainer "ContosoArchives"

このコマンドは、Get-AzStorageContainer コマンドレットを使用して ContosoUploads という名前のコンテナーを取得し、パイプライン 演算子を使用して現在のコマンドレットにコンテナーを渡します。 このコマンドレットは、ContosoPlanning2015 という名前の BLOB のコピー操作を開始します。 前のコマンドレットは、ソース コンテナーを提供します。 DestContainer パラメーターは、ContosoArchives を宛先コンテナーとして指定します。

例 3: コンテナー内のすべての BLOB を取得してコピーする

Get-AzStorageBlob -Container "ContosoUploads" | Start-AzStorageBlobCopy -DestContainer "ContosoArchives"

このコマンドは、Get-AzStorageBlob コマンドレットを使用して ContosoUploads という名前のコンテナー内の BLOB を取得し、パイプライン演算子を使用して現在のコマンドレットに結果を渡します。 このコマンドレットは、ContosoArchives という名前のコンテナーへの BLOB のコピー操作を開始します。

例 4: オブジェクトとして指定された BLOB をコピーする

$SrcBlob = Get-AzStorageBlob -Container "ContosoUploads" -Blob "ContosoPlanning2015"
$DestBlob = Get-AzStorageBlob -Container "ContosoArchives" -Blob "ContosoPlanning2015Archived"
Start-AzStorageBlobCopy -ICloudBlob $SrcBlob.ICloudBlob -DestICloudBlob $DestBlob.ICloudBlob

最初のコマンドは、ContosoUploads という名前のコンテナー内の ContosoPlanning2015 という名前の BLOB を取得します。 このコマンドは、そのオブジェクトを $SrcBlob 変数に格納します。 2 番目のコマンドは、ContosoArchives という名前のコンテナー内の ContosoPlanning2015Archived という名前の BLOB を取得します。 このコマンドは、そのオブジェクトを $DestBlob 変数に格納します。 最後のコマンドは、コピー元コンテナーからコピー先コンテナーへのコピー操作を開始します。 このコマンドでは、標準のドット表記を使用して、 $SrcBlobと$DestBlob BLOB の ICloudBlob オブジェクトを指定します。

例 5: URI から BLOB をコピーする

$Context = New-AzStorageContext -StorageAccountName "ContosoGeneral" -StorageAccountKey "< Storage Key for ContosoGeneral ends with == >"
Start-AzStorageBlobCopy -AbsoluteUri "http://www.contosointernal.com/planning" -DestContainer "ContosoArchive" -DestBlob "ContosoPlanning2015" -DestContext $Context

このコマンドは、指定したキーを使用する ContosoGeneral という名前のアカウントのコンテキストを作成し、そのキーを$Context変数に格納します。 2 番目のコマンドは、指定した URI から ContosoArchive という名前のコンテナー内の ContosoPlanning という名前の BLOB にファイルをコピーします。 このコマンドは、$Contextに格納されているコピー先コンテキストへのコピー操作を開始します。 ソース ストレージ コンテキストがないため、ソース URI はソース オブジェクトにアクセスできる必要があります。 たとえば、ソースがパブリック Azure BLOB でない場合、URI には BLOB への読み取りアクセス権を持つ SAS トークンが含まれている必要があります。

例 6: 新しい BLOB 名を使用してブロック BLOB をコピー先コンテナーにコピーし、宛先 BLOB StandardBlobTier をホット、RehydratePriority を High に設定する

Start-AzStorageBlobCopy -SrcContainer "ContosoUploads" -SrcBlob "BlockBlobName" -DestContainer "ContosoArchives" -DestBlob "NewBlockBlobName" -StandardBlobTier Hot -RehydratePriority High

このコマンドは、ブロック BLOB のコピー操作を新しい BLOB 名で宛先コンテナーに開始し、宛先 BLOB StandardBlobTier をホット、RehydratePriority を High に設定します。

パラメーター

-AbsoluteUri

Azure Storage BLOB にコピーするファイルの絶対 URI を指定します。

Type:String
Aliases:SrcUri, SourceUri
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-BlobBaseClient

BlobBaseClient オブジェクト

Type:BlobBaseClient
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ClientTimeoutPerRequest

1 つのサービス要求に対するクライアント側のタイムアウト間隔を秒単位で指定します。 指定した間隔で前の呼び出しが失敗した場合、このコマンドレットは要求を再試行します。 間隔が経過する前にこのコマンドレットが正常な応答を受け取らない場合、このコマンドレットはエラーを返します。

Type:Nullable<T>[Int32]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CloudBlob

Azure Storage クライアント ライブラリの CloudBlob オブジェクトを指定します。 CloudBlob オブジェクトを取得するには、Get-AzStorageBlob コマンドレットを使用します。

Type:CloudBlob
Aliases:SrcICloudBlob, SrcCloudBlob, ICloudBlob, SourceICloudBlob, SourceCloudBlob
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CloudBlobContainer

Azure Storage クライアント ライブラリの CloudBlobContainer オブジェクトを指定します。 このコマンドレットは、このパラメーターが指定するコンテナーから BLOB をコピーします。 CloudBlobContainer オブジェクトを取得するには、Get-AzStorageContainer コマンドレットを使用します。

Type:CloudBlobContainer
Aliases:SourceCloudBlobContainer
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ConcurrentTaskCount

同時ネットワーク呼び出しの最大数を指定します。 このパラメーターを使用すると、同時ネットワーク呼び出しの最大数を指定することで、ローカル CPU と帯域幅の使用量を調整するコンカレンシーを制限できます。 指定した値は絶対カウントであり、コア数には乗算されません。 このパラメーターは、1 秒あたり 100 キロビットなどの低帯域幅環境でのネットワーク接続の問題を減らすのに役立ちます。 既定値は 10 です。

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

Azure ストレージ コンテキストを指定します。 ストレージ コンテキストを取得するには、New-AzStorageContext コマンドレットを使用します。

Type:IStorageContext
Aliases:SrcContext, SourceContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DestBlob

宛先 BLOB の名前を指定します。

Type:String
Aliases:DestinationBlob
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DestCloudBlob

コピー先 の CloudBlob オブジェクトを指定します。

Type:CloudBlob
Aliases:DestICloudBlob, DestinationCloudBlob, DestinationICloudBlob
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DestContainer

宛先コンテナーの名前を指定します。

Type:String
Aliases:DestinationContainer
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DestContext

Azure ストレージ コンテキストを指定します。 ストレージ コンテキストを取得するには、New-AzStorageContext コマンドレットを使用します。

Type:IStorageContext
Aliases:DestinationContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DestTagCondition

ターゲット BLOB の一致条件をチェックするオプションの Tag 式ステートメント。 コピー先の BLOB タグが指定された式と一致しない場合、BLOB 要求は失敗します。 詳細については、 https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations を確認してください。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

このコマンドレットは、確認を求めずに宛先 BLOB を上書きすることを示します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PremiumPageBlobTier

プレミアム ページ BLOB 層

Type:PremiumPageBlobTier
Accepted values:Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RehydratePriority

ブロック BLOB リハイドレートPriority。 アーカイブされた BLOB のリハイドレートに使用する優先度を示します。 有効な値は High/Standard です。

Type:RehydratePriority
Accepted values:Standard, High
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

要求のサービス側のタイムアウト間隔を秒単位で指定します。 サービスが要求を処理する前に指定した間隔が経過すると、ストレージ サービスはエラーを返します。

Type:Nullable<T>[Int32]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SrcBlob

ソース BLOB の名前を指定します。

Type:String
Aliases:SourceBlob
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SrcContainer

ソース コンテナーの名前を指定します。

Type:String
Aliases:SourceContainer
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SrcDir

Azure Storage クライアント ライブラリの CloudFileDirectory オブジェクトを指定します。

Type:CloudFileDirectory
Aliases:SourceDir
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SrcFile

Azure Storage クライアント ライブラリの CloudFile オブジェクトを指定します。 これを作成することも、Get-AzStorageFile コマンドレットを使用することもできます。

Type:CloudFile
Aliases:SourceFile
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SrcFilePath

ソース ディレクトリまたはソース共有のソース ファイルの相対パスを指定します。

Type:String
Aliases:SourceFilePath
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SrcShare

Azure Storage クライアント ライブラリの CloudFileShare オブジェクトを指定します。 作成することも、Get-AzStorageShare コマンドレットを使用することもできます。

Type:CloudFileShare
Aliases:SourceShare
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SrcShareName

ソース共有名を指定します。

Type:String
Aliases:SourceShareName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-StandardBlobTier

ブロック BLOB 層。有効な値はホット/クール/アーカイブ/コールドです。 詳細については、以下を参照してください。 https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

BLOB タグ

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TagCondition

ソース BLOB の一致条件をチェックするオプションの Tag 式ステートメント。 ソース BLOB タグが指定された式と一致しない場合、BLOB 要求は失敗します。 詳細については、 https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations を確認してください。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

CloudBlob

CloudBlobContainer

CloudFile

String

IStorageContext

出力

AzureStorageBlob