다음을 통해 공유


Copy-AzStorageBlob

Blob을 동기적으로 복사합니다.

구문

Copy-AzStorageBlob
    [-SrcBlob] <String>
    -SrcContainer <String>
    -DestContainer <String>
    [-DestBlob <String>]
    [-DestBlobType <String>]
    [-StandardBlobTier <String>]
    [-RehydratePriority <RehydratePriority>]
    [-EncryptionScope <String>]
    [-Context <IStorageContext>]
    [-DestContext <IStorageContext>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Copy-AzStorageBlob
    [-BlobBaseClient <BlobBaseClient>]
    -DestContainer <String>
    [-DestBlob <String>]
    [-DestBlobType <String>]
    [-StandardBlobTier <String>]
    [-RehydratePriority <RehydratePriority>]
    [-EncryptionScope <String>]
    [-Context <IStorageContext>]
    [-DestContext <IStorageContext>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Copy-AzStorageBlob
    -AbsoluteUri <String>
    -DestContainer <String>
    -DestBlob <String>
    [-DestBlobType <String>]
    [-StandardBlobTier <String>]
    [-RehydratePriority <RehydratePriority>]
    [-EncryptionScope <String>]
    [-Context <IStorageContext>]
    [-DestContext <IStorageContext>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Copy-AzStorageBlob cmdlet은 Blob을 동기적으로 복사하며 현재 블록 Blob만 지원합니다.

예제

예제 1: 명명된 Blob을 다른 Blob에 복사

$destBlob = Copy-AzStorageBlob -SrcContainer "sourcecontainername" -SrcBlob "srcblobname" -DestContainer "destcontainername" -DestBlob "destblobname"

이 명령은 새 Blob 이름을 사용하여 원본 컨테이너에서 대상 컨테이너로 Blob을 복사합니다.

예제 2: Blob 개체에서 Blob 복사

$srcBlob = Get-AzStorageBlob -Container $containerName -Blob $blobName  -Context $ctx 
$destBlob =  $srcBlob | Copy-AzStorageBlob  -DestContainer "destcontainername" -DestBlob "destblobname"

이 명령은 새 Blob 이름을 사용하여 원본 Blob 개체에서 대상 컨테이너로 Blob을 복사합니다.

예제 3: Blob Uri에서 Blob 복사

$srcBlobUri = New-AzStorageBlobSASToken -Container $srcContainerName -Blob $srcBlobName -Permission rt -ExpiryTime (Get-Date).AddDays(7) -FullUri 
$destBlob = Copy-AzStorageBlob -AbsoluteUri $srcBlobUri -DestContainer "destcontainername" -DestBlob "destblobname"

첫 번째 명령은 사용 권한 "rt"의 sas 토큰을 사용하여 원본 Blob의 Blob Uri를 만듭니다. 두 번째 명령은 원본 Blob Uri에서 대상 Blob으로 복사합니다.

예제 4: 블록 Blob 암호화 범위 업데이트

$blob = Copy-AzStorageBlob -SrcContainer $containerName -SrcBlob $blobname -DestContainer $containername -EncryptionScope $newScopeName -Force

이 명령은 블록 Blob 암호화 범위를 새 암호화 범위로 자체에 복사하여 업데이트합니다.

예제 5: 새 추가 Blob에 Blob 복사

$srcBlob = Get-AzStorageBlob -Container $containerName -Blob $blobName  -Context $ctx 
$destBlob = Copy-AzStorageBlob -SrcContainer "sourcecontainername" -SrcBlob "srcblobname" -DestContainer "destcontainername" -DestBlob "destblobname" -DestBlobType "Append" -DestContext $destCtx

매개 변수

-AbsoluteUri

원본 Blob uri

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

-AsJob

백그라운드에서 cmdlet 실행

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

-BlobBaseClient

BlobBaseClient 개체

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

-Confirm

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

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

-Context

원본 Azure Storage 컨텍스트 개체

형식: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

-DestBlobType

대상 Blob 유형

형식:String
허용되는 값:Block, Page, Append
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DestContainer

대상 컨테이너 이름

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

-DestContext

Destination Storage 컨텍스트 개체

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

-EncryptionScope

dest Blob에 요청할 때 사용할 암호화 범위입니다.

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

-Force

기존 Blob 또는 파일을 강제로 덮어쓰기

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

-RehydratePriority

블록 Blob RehydratePriority. 보관된 Blob을 다시 수화할 우선 순위를 나타냅니다. 유효한 값은 높음/표준입니다.

형식:RehydratePriority
허용되는 값:Standard, High
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

-StandardBlobTier

블록 Blob 계층, 유효한 값은 핫/쿨/보관/콜드입니다. 에서 세부 정보 보기 https://learn.microsoft.com/en-us/azure/storage/blobs/storage-blob-storage-tiers

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

-TagCondition

일치 조건을 확인하는 선택적 태그 식 문입니다. Blob 태그가 지정된 식과 일치하지 않으면 Blob 요청이 실패합니다. 에서 세부 정보를 참조하세요 https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

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

-WhatIf

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

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

입력

BlobBaseClient

String

IStorageContext

출력

AzureStorageBlob