Bagikan melalui


Start-AzStorageBlobCopy

Mulai menyalin blob.

Sintaks

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

Deskripsi

Cmdlet Start-AzStorageBlobCopy mulai menyalin blob.

Contoh

Contoh 1: Menyalin blob bernama

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

Perintah ini memulai operasi penyalinan blob bernama ContosoPlanning2015 dari kontainer bernama ContosoUploads ke kontainer bernama ContosoArchives.

Contoh 2: Dapatkan kontainer untuk menentukan blob yang akan disalin

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

Perintah ini mendapatkan kontainer bernama ContosoUploads, dengan menggunakan cmdlet Get-AzStorageContainer , lalu meneruskan kontainer ke cmdlet saat ini dengan menggunakan operator alur. Cmdlet itu memulai operasi salin blob bernama ContosoPlanning2015. Cmdlet sebelumnya menyediakan kontainer sumber. Parameter DestContainer menentukan ContosoArchives sebagai kontainer tujuan.

Contoh 3: Dapatkan semua blob dalam kontainer dan salin

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

Perintah ini mendapatkan blob dalam kontainer bernama ContosoUploads, dengan menggunakan cmdlet Get-AzStorageBlob , lalu meneruskan hasilnya ke cmdlet saat ini dengan menggunakan operator alur. Cmdlet itu memulai operasi penyalinan blob ke kontainer bernama ContosoArchives.

Contoh 4: Menyalin blob yang ditentukan sebagai objek

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

Perintah pertama mendapatkan blob bernama ContosoPlanning2015 dalam kontainer bernama ContosoUploads. Perintah menyimpan objek tersebut dalam variabel $SrcBlob. Perintah kedua mendapatkan blob bernama ContosoPlanning2015Archived dalam kontainer bernama ContosoArchives. Perintah menyimpan objek tersebut dalam variabel $DestBlob. Perintah terakhir memulai operasi salin dari kontainer sumber ke kontainer tujuan. Perintah menggunakan notasi titik standar untuk menentukan objek ICloudBlob untuk blob $SrcBlob dan $DestBlob.

Contoh 5: Menyalin blob dari URI

$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

Perintah ini membuat konteks untuk akun bernama ContosoGeneral yang menggunakan kunci yang ditentukan, lalu menyimpan kunci tersebut dalam variabel $Context. Perintah kedua menyalin file dari URI yang ditentukan ke blob bernama ContosoPlanning dalam kontainer bernama ContosoArchive. Perintah memulai operasi salin ke konteks tujuan yang disimpan di $Context. Tidak ada konteks penyimpanan sumber, sehingga Uri sumber harus memiliki akses ke objek sumber. Misalnya: jika sumbernya bukan blob Azure publik, Uri harus berisi token SAS yang memiliki akses baca ke blob.

Contoh 6: Salin blob blok ke kontainer tujuan dengan nama blob baru, dan tetapkan blob tujuan StandardBlobTier sebagai Panas, RehydratePriority sebagai Tinggi

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

Perintah ini memulai operasi salin blob blok ke kontainer tujuan dengan nama blob baru, dan mengatur blob tujuan StandardBlobTier sebagai Panas, RehydratePriority sebagai Tinggi

Parameter

-AbsoluteUri

Menentukan URI absolut file untuk disalin ke blob Azure Storage.

Jenis:String
Alias:SrcUri, SourceUri
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-BlobBaseClient

Objek BlobBaseClient

Jenis:BlobBaseClient
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ClientTimeoutPerRequest

Menentukan interval waktu habis sisi klien, dalam hitungan detik, untuk satu permintaan layanan. Jika panggilan sebelumnya gagal dalam interval yang ditentukan, cmdlet ini akan mencoba kembali permintaan. Jika cmdlet ini tidak menerima respons yang berhasil sebelum interval berlalu, cmdlet ini mengembalikan kesalahan.

Jenis:Nullable<T>[Int32]
Alias:ClientTimeoutPerRequestInSeconds
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-CloudBlob

Menentukan objek CloudBlob dari pustaka Klien Azure Storage. Untuk mendapatkan objek CloudBlob , gunakan cmdlet Get-AzStorageBlob.

Jenis:CloudBlob
Alias:SrcICloudBlob, SrcCloudBlob, ICloudBlob, SourceICloudBlob, SourceCloudBlob
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-CloudBlobContainer

Menentukan objek CloudBlobContainer dari pustaka Klien Azure Storage. Cmdlet ini menyalin blob dari kontainer yang ditentukan parameter ini. Untuk mendapatkan objek CloudBlobContainer , gunakan cmdlet Get-AzStorageContainer.

Jenis:CloudBlobContainer
Alias:SourceCloudBlobContainer
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-ConcurrentTaskCount

Menentukan panggilan jaringan bersamaan maksimum. Anda dapat menggunakan parameter ini untuk membatasi konkurensi untuk membatasi penggunaan CPU dan bandwidth lokal dengan menentukan jumlah maksimum panggilan jaringan bersamaan. Nilai yang ditentukan adalah jumlah absolut dan tidak dikalikan dengan jumlah inti. Parameter ini dapat membantu mengurangi masalah koneksi jaringan di lingkungan bandwidth rendah, seperti 100 kilobit per detik. Nilai defaultnya adalah 10.

Jenis:Nullable<T>[Int32]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Context

Menentukan konteks penyimpanan Azure. Untuk mendapatkan konteks penyimpanan, gunakan cmdlet New-AzStorageContext.

Jenis:IStorageContext
Alias:SrcContext, SourceContext
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Jenis:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DestBlob

Menentukan nama blob tujuan.

Jenis:String
Alias:DestinationBlob
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-DestCloudBlob

Menentukan objek CloudBlob tujuan

Jenis:CloudBlob
Alias:DestICloudBlob, DestinationCloudBlob, DestinationICloudBlob
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-DestContainer

Menentukan nama kontainer tujuan.

Jenis:String
Alias:DestinationContainer
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-DestContext

Menentukan konteks penyimpanan Azure. Untuk mendapatkan konteks penyimpanan, gunakan cmdlet New-AzStorageContext.

Jenis:IStorageContext
Alias:DestinationContext
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-DestTagCondition

Pernyataan ekspresi Tag opsional untuk memeriksa kondisi kecocokan pada Blob tujuan. Permintaan blob akan gagal ketika tag blob tujuan tidak cocok dengan ekspresi yang diberikan. Lihat detailnya di https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Force

Menunjukkan bahwa cmdlet ini menimpa blob tujuan tanpa meminta konfirmasi kepada Anda.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-PremiumPageBlobTier

Tingkat Blob Halaman Premium

Jenis:PremiumPageBlobTier
Nilai yang diterima:Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-RehydratePriority

Blokir Blob RehydratePriority. Menunjukkan prioritas untuk merehidrasi blob yang diarsipkan. Nilai yang valid adalah Tinggi/Standar.

Jenis:RehydratePriority
Nilai yang diterima:Standard, High
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ServerTimeoutPerRequest

Menentukan interval waktu habis sisi layanan, dalam hitungan detik, untuk permintaan. Jika interval yang ditentukan berlalu sebelum layanan memproses permintaan, layanan penyimpanan mengembalikan kesalahan.

Jenis:Nullable<T>[Int32]
Alias:ServerTimeoutPerRequestInSeconds
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-SrcBlob

Menentukan nama blob sumber.

Jenis:String
Alias:SourceBlob
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-SrcContainer

Menentukan nama kontainer sumber.

Jenis:String
Alias:SourceContainer
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-SrcDir

Menentukan objek CloudFileDirectory dari pustaka Klien Azure Storage.

Jenis:CloudFileDirectory
Alias:SourceDir
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-SrcFile

Menentukan objek CloudFile dari pustaka Klien Azure Storage. Anda dapat membuatnya atau menggunakan cmdlet Get-AzStorageFile.

Jenis:CloudFile
Alias:SourceFile
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-SrcFilePath

Menentukan jalur relatif file sumber direktori sumber atau berbagi sumber.

Jenis:String
Alias:SourceFilePath
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-SrcShare

Menentukan objek CloudFileShare dari pustaka Klien Azure Storage. Anda dapat membuatnya atau menggunakan cmdlet Get-AzStorageShare.

Jenis:CloudFileShare
Alias:SourceShare
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-SrcShareName

Menentukan nama berbagi sumber.

Jenis:String
Alias:SourceShareName
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-StandardBlobTier

Tingkat Blob Blok, nilai yang valid adalah Panas/Dingin/Arsip/Dingin. Lihat detail di https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Tag

Tag Blob

Jenis:Hashtable
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-TagCondition

Pernyataan ekspresi Tag opsional untuk memeriksa kondisi kecocokan pada blob sumber. Permintaan blob akan gagal ketika tag blob sumber tidak cocok dengan ekspresi yang diberikan. Lihat detailnya di https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:False
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

CloudBlob

CloudBlobContainer

CloudFile

String

IStorageContext

Output

AzureStorageBlob