다음을 통해 공유

Start-AzureStorageBlobCopy

  • 참조
모듈:
Azure.Storage

Blob 복사를 시작합니다.

Warning

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>]

Description

Start-AzureStorageBlobCopy cmdlet은 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 cmdlet을 사용하여 ContosoUploads라는 컨테이너를 가져오고 파이프라인 연산자를 사용하여 컨테이너를 현재 cmdlet에 전달합니다. 이 cmdlet은 ContosoPlanning2015라는 Blob의 복사 작업을 시작합니다. 이전 cmdlet은 원본 컨테이너를 제공합니다. DestContainer 매개 변수는 ContosoArchives를 대상 컨테이너로 지정합니다.

예제 3: 컨테이너의 모든 Blob 가져오기 및 복사

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

이 명령은 Get-AzureStorageBlob cmdlet을 사용하여 ContosoUploads라는 컨테이너의 Blob을 가져오고 파이프라인 연산자를 사용하여 결과를 현재 cmdlet에 전달합니다. 이 cmdlet은 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 변수에 저장합니다. 두 번째 명령은 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 변수에 저장합니다. 두 번째 명령은 지정된 URI의 파일을 ContosoArchive라는 컨테이너의 ContosoPlanning이라는 Blob에 복사합니다. 이 명령은 $Context 저장된 컨텍스트에서 복사 작업을 시작합니다.

매개 변수

-AbsoluteUri

Azure Storage Blob에 복사할 파일의 절대 URI를 지정합니다.

형식:String
별칭:SrcUri, SourceUri
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ClientTimeoutPerRequest

하나의 서비스 요청에 대한 클라이언트 쪽 제한 시간 간격(초)을 지정합니다. 이전 호출이 지정된 간격으로 실패하면 이 cmdlet은 요청을 다시 시도합니다. 이 cmdlet이 간격이 경과하기 전에 성공적인 응답을 받지 못하면 이 cmdlet은 오류를 반환합니다.

형식:Nullable<T>[Int32]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-CloudBlob

Azure Storage 클라이언트 라이브러리에서 CloudBlob 개체를 지정합니다. CloudBlob 개체를 가져오려면 Get-AzureStorageBlob cmdlet을 사용합니다.

형식:CloudBlob
별칭:SrcICloudBlob, SrcCloudBlob, ICloudBlob, SourceICloudBlob, SourceCloudBlob
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-CloudBlobContainer

Azure Storage 클라이언트 라이브러리에서 CloudBlobContainer 개체를 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 컨테이너에서 Blob을 복사합니다. CloudBlobContainer 개체를 가져오려면 Get-AzureStorageContainer cmdlet을 사용합니다.

형식:CloudBlobContainer
별칭:SourceCloudBlobContainer
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ConcurrentTaskCount

최대 동시 네트워크 호출을 지정합니다. 이 매개 변수를 사용하여 동시 네트워크 호출의 최대 수를 지정하여 로컬 CPU 및 대역폭 사용을 제한하는 동시성을 제한할 수 있습니다. 지정된 값은 절대 개수이며 코어 수를 곱하지 않습니다. 이 매개 변수는 초당 100킬로비트와 같은 낮은 대역폭 환경에서 네트워크 연결 문제를 줄이는 데 도움이 될 수 있습니다. 기본값은 10입니다.

형식:Nullable<T>[Int32]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Context

Azure Storage 컨텍스트를 지정합니다. 스토리지 컨텍스트를 가져오려면 New-AzureStorageContext cmdlet을 사용합니다.

형식:IStorageContext
별칭:SrcContext, SourceContext
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
별칭:AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DestBlob

대상 Blob의 이름을 지정합니다.

형식:String
별칭:DestinationBlob
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DestCloudBlob

대상 CloudBlob 개체를 지정합니다.

형식:CloudBlob
별칭:DestICloudBlob, DestinationCloudBlob, DestinationICloudBlob
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DestContainer

대상 컨테이너의 이름을 지정합니다.

형식:String
별칭:DestinationContainer
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DestContext

Azure Storage 컨텍스트를 지정합니다. 스토리지 컨텍스트를 가져오려면 New-AzureStorageContext cmdlet을 사용합니다.

형식:IStorageContext
별칭:DestinationContext
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

이 cmdlet은 확인 메시지를 표시하지 않고 대상 Blob을 덮어씁니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PremiumPageBlobTier

프리미엄 페이지 Blob 계층

형식:PremiumPageBlobTier
허용되는 값:Unknown, P4, P6, P10, P20, P30, P40, P50, P60
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ServerTimeoutPerRequest

요청에 대한 서비스 쪽 제한 시간 간격(초)을 지정합니다. 서비스에서 요청을 처리하기 전에 지정된 간격이 경과하면 스토리지 서비스가 오류를 반환합니다.

형식:Nullable<T>[Int32]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SrcBlob

원본 Blob의 이름을 지정합니다.

형식:String
별칭:SourceBlob
Position:0
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SrcContainer

원본 컨테이너의 이름을 지정합니다.

형식:String
별칭:SourceContainer
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SrcDir

Azure Storage 클라이언트 라이브러리에서 CloudFileDirectory 개체를 지정합니다.

형식:CloudFileDirectory
별칭:SourceDir
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SrcFile

Azure Storage 클라이언트 라이브러리에서 CloudFile 개체를 지정합니다. 만들거나 Get-AzureStorageFile cmdlet을 사용할 수 있습니다.

형식:CloudFile
별칭:SourceFile
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-SrcFilePath

원본 디렉터리 또는 원본 공유의 원본 파일 상대 경로를 지정합니다.

형식:String
별칭:SourceFilePath
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SrcShare

Azure Storage 클라이언트 라이브러리에서 CloudFileShare 개체를 지정합니다. 만들거나 Get-AzureStorageShare cmdlet을 사용할 수 있습니다.

형식:CloudFileShare
별칭:SourceShare
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SrcShareName

원본 공유 이름을 지정합니다.

형식:String
별칭:SourceShareName
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

CloudBlob

CloudBlobContainer

CloudFile

매개 변수: SrcFile(ByValue)

String

IStorageContext

출력

AzureStorageBlob