Start-AzureStorageBlobCopy

リファレンス

モジュール:: Azure.Storage

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

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

Start-AzureStorageBlobCopy
     [-SrcBlob] <String>
     -SrcContainer <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureStorageBlobCopy
     -CloudBlob <CloudBlob>
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureStorageBlobCopy
     -CloudBlob <CloudBlob>
     -DestCloudBlob <CloudBlob>
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureStorageBlobCopy
     -CloudBlobContainer <CloudBlobContainer>
     [-SrcBlob] <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-PremiumPageBlobTier <PremiumPageBlobTier>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureStorageBlobCopy
     -SrcShareName <String>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureStorageBlobCopy
     -SrcShare <CloudFileShare>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureStorageBlobCopy
     -SrcDir <CloudFileDirectory>
     -SrcFilePath <String>
     -DestContainer <String>
     [-DestBlob <String>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureStorageBlobCopy
     -SrcFile <CloudFile>
     -DestContainer <String>
     [-DestBlob <String>]
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureStorageBlobCopy
     -SrcFile <CloudFile>
     -DestCloudBlob <CloudBlob>
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-AzureStorageBlobCopy
     -AbsoluteUri <String>
     -DestContainer <String>
     -DestBlob <String>
     [-Context <IStorageContext>]
     [-DestContext <IStorageContext>]
     [-Force]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

説明

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

例

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

C:\PS>Start-AzureStorageBlobCopy -SrcBlob "ContosoPlanning2015" -DestContainer "ContosoArchives" -SrcContainer "ContosoUploads"

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

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

C:\PS>Get-AzureStorageContainer -Name "ContosoUploads" | Start-AzureStorageBlobCopy -SrcBlob "ContosoPlanning2015" -DestContainer "ContosoArchives"

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

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

C:\PS>Get-AzureStorageBlob -Container "ContosoUploads" | Start-AzureStorageBlobCopy -DestContainer "ContosoArchives"

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

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

C:\PS>$SrcBlob = Get-AzureStorageBlob -Container "ContosoUploads" -Blob "ContosoPlanning2015"
C:\PS> $DestBlob = Get-AzureStorageBlob -Container "ContosoArchives" -Blob "ContosoPlanning2015Archived"
C:\PS> Start-AzureStorageBlobCopy -ICloudBlob $SrcBlob.ICloudBlob -DestICloudBlob $DestBlob.ICloudBlob

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

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

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

このコマンドは、指定したキーを使用する ContosoGeneral という名前のアカウントのコンテキストを作成し、そのキーを$Context変数に格納します。 2 番目のコマンドは、指定した URI から ContosoArchive という名前のコンテナー内の ContosoPlanning という名前の BLOB にファイルをコピーします。このコマンドは、$Contextに格納されているコンテキストでコピー操作を開始します。

パラメーター

-AbsoluteUri

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

型:	String
Aliases:	SrcUri, SourceUri
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-ClientTimeoutPerRequest

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

型:	Nullable<T>[Int32]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CloudBlob

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

型:	CloudBlob
Aliases:	SrcICloudBlob, SrcCloudBlob, ICloudBlob, SourceICloudBlob, SourceCloudBlob
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-CloudBlobContainer

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

型:	CloudBlobContainer
Aliases:	SourceCloudBlobContainer
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-ConcurrentTaskCount

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

型:	Nullable<T>[Int32]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

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

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Context

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

型:	IStorageContext
Aliases:	SrcContext, SourceContext
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-DefaultProfile

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

型:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DestBlob

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

型:	String
Aliases:	DestinationBlob
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DestCloudBlob

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

型:	CloudBlob
Aliases:	DestICloudBlob, DestinationCloudBlob, DestinationICloudBlob
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DestContainer

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

型:	String
Aliases:	DestinationContainer
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DestContext

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

型:	IStorageContext
Aliases:	DestinationContext
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Force

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PremiumPageBlobTier

プレミアムページ BLOB 層

型:	PremiumPageBlobTier
指定可能な値:	Unknown, P4, P6, P10, P20, P30, P40, P50, P60
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ServerTimeoutPerRequest

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

型:	Nullable<T>[Int32]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SrcBlob

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

型:	String
Aliases:	SourceBlob
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SrcContainer

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

型:	String
Aliases:	SourceContainer
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SrcDir

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

型:	CloudFileDirectory
Aliases:	SourceDir
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SrcFile

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

型:	CloudFile
Aliases:	SourceFile
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-SrcFilePath

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

型:	String
Aliases:	SourceFilePath
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SrcShare

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

型:	CloudFileShare
Aliases:	SourceShare
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SrcShareName

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

型:	String
Aliases:	SourceShareName
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

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

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

CloudBlob

CloudBlobContainer

CloudFile

パラメーター: SrcFile (ByValue)

String

IStorageContext

出力

AzureStorageBlob

次の方法で共有

Start-AzureStorageBlobCopy

構文

説明

例

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

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

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

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

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

パラメーター

-AbsoluteUri

-ClientTimeoutPerRequest

-CloudBlob

-CloudBlobContainer

-ConcurrentTaskCount

-Confirm

-Context

-DefaultProfile

-DestBlob

-DestCloudBlob

-DestContainer

-DestContext

-Force

-PremiumPageBlobTier

-ServerTimeoutPerRequest

-SrcBlob

-SrcContainer

-SrcDir

-SrcFile

-SrcFilePath

-SrcShare

-SrcShareName

-WhatIf

入力

出力

その他のリソース

次の方法で共有

Start-AzureStorageBlobCopy

構文

説明

例

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

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

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

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

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

パラメーター

-AbsoluteUri

-ClientTimeoutPerRequest

-CloudBlob

-CloudBlobContainer

-ConcurrentTaskCount

-Confirm

-Context

-DefaultProfile

-DestBlob

-DestCloudBlob

-DestContainer

-DestContext

-Force

-PremiumPageBlobTier

-ServerTimeoutPerRequest

-SrcBlob

-SrcContainer

-SrcDir

-SrcFile

-SrcFilePath

-SrcShare

-SrcShareName

-WhatIf

入力

出力

関連リンク

その他のリソース