Dela via


Start-AzStorageBlobCopy

Börjar kopiera en blob.

Syntax

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

Description

Cmdleten Start-AzStorageBlobCopy börjar kopiera en blob.

Exempel

Exempel 1: Kopiera en namngiven blob

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

Det här kommandot startar kopieringsåtgärden av bloben med namnet ContosoPlanning2015 från containern med namnet ContosoUploads till containern ContosoArchives.

Exempel 2: Hämta en container för att ange blobar som ska kopieras

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

Det här kommandot hämtar containern ContosoUploads med hjälp av cmdleten Get-AzStorageContainer och skickar sedan containern till den aktuella cmdleten med hjälp av pipelineoperatorn. Den cmdleten startar kopieringsåtgärden för bloben med namnet ContosoPlanning2015. Den tidigare cmdleten innehåller källcontainern. Parametern DestContainer anger ContosoArchives som målcontainer.

Exempel 3: Hämta alla blobar i en container och kopiera dem

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

Det här kommandot hämtar blobarna i containern med namnet ContosoUploads med hjälp av cmdleten Get-AzStorageBlob och skickar sedan resultatet till den aktuella cmdleten med hjälp av pipelineoperatorn. Den cmdleten startar kopieringsåtgärden av blobarna till containern ContosoArchives.

Exempel 4: Kopiera en blob som angetts som ett objekt

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

Det första kommandot hämtar bloben med namnet ContosoPlanning2015 i containern med namnet ContosoUploads. Kommandot lagrar objektet i variabeln $SrcBlob. Det andra kommandot hämtar bloben contosoPlanning2015Archived i containern med namnet ContosoArchives. Kommandot lagrar objektet i variabeln $DestBlob. Det sista kommandot startar kopieringsåtgärden från källcontainern till målcontainern. Kommandot använder standardpunkts notation för att ange ICloudBlob-objekt för $SrcBlob och $DestBlob blobar.

Exempel 5: Kopiera en blob från en 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

Det här kommandot skapar en kontext för kontot med namnet ContosoGeneral som använder den angivna nyckeln och lagrar sedan den nyckeln i variabeln $Context. Det andra kommandot kopierar filen från den angivna URI:n till bloben ContosoPlanning i containern med namnet ContosoArchive. Kommandot startar kopieringsåtgärden till målkontexten som lagras i $Context. Det finns ingen källlagringskontext, så käll-URI:n måste ha åtkomst till källobjektet. T.ex. om källan inte är en offentlig Azure-blob ska URI:n innehålla SAS-token som har läsbehörighet till bloben.

Exempel 6: Kopiera en blockblob till målcontainern med ett nytt blobnamn och ange målbloben StandardBlobTier som Frekvent, RehydratePriority som Hög

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

Det här kommandot startar kopieringsåtgärden för en blockblob till målcontainer med ett nytt blobnamn och anger målbloben StandardBlobTier som Frekvent, RehydratePriority som Hög

Parametrar

-AbsoluteUri

Anger den absoluta URI:n för en fil som ska kopieras till en Azure Storage-blob.

Typ:String
Alias:SrcUri, SourceUri
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-BlobBaseClient

BlobBaseClient-objekt

Typ:BlobBaseClient
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ClientTimeoutPerRequest

Anger tidsgränsen på klientsidan i sekunder för en tjänstbegäran. Om det föregående anropet misslyckas i det angivna intervallet försöker den här cmdleten skicka begäran igen. Om den här cmdleten inte får något lyckat svar innan intervallet förflutit returnerar den här cmdleten ett fel.

Typ:Nullable<T>[Int32]
Alias:ClientTimeoutPerRequestInSeconds
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-CloudBlob

Anger ett CloudBlob-objekt från Azure Storage-klientbiblioteket. Om du vill hämta ett CloudBlob-objekt använder du cmdleten Get-AzStorageBlob.

Typ:CloudBlob
Alias:SrcICloudBlob, SrcCloudBlob, ICloudBlob, SourceICloudBlob, SourceCloudBlob
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-CloudBlobContainer

Anger ett CloudBlobContainer-objekt från Azure Storage-klientbiblioteket. Den här cmdleten kopierar en blob från containern som den här parametern anger. Om du vill hämta ett CloudBlobContainer-objekt använder du cmdleten Get-AzStorageContainer.

Typ:CloudBlobContainer
Alias:SourceCloudBlobContainer
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ConcurrentTaskCount

Anger maximalt antal samtidiga nätverksanrop. Du kan använda den här parametern för att begränsa samtidigheten för att begränsa den lokala processor- och bandbreddsanvändningen genom att ange det maximala antalet samtidiga nätverksanrop. Det angivna värdet är ett absolut antal och multipliceras inte med kärnantalet. Den här parametern kan bidra till att minska problem med nätverksanslutningar i miljöer med låg bandbredd, till exempel 100 kilobit per sekund. Standardvärdet är 10.

Typ:Nullable<T>[Int32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Context

Anger en Azure Storage-kontext. Om du vill hämta en lagringskontext använder du cmdleten New-AzStorageContext.

Typ:IStorageContext
Alias:SrcContext, SourceContext
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DestBlob

Anger namnet på målbloben.

Typ:String
Alias:DestinationBlob
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DestCloudBlob

Anger ett CloudBlob-målobjekt

Typ:CloudBlob
Alias:DestICloudBlob, DestinationCloudBlob, DestinationICloudBlob
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DestContainer

Anger namnet på målcontainern.

Typ:String
Alias:DestinationContainer
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DestContext

Anger en Azure Storage-kontext. Om du vill hämta en lagringskontext använder du cmdleten New-AzStorageContext.

Typ:IStorageContext
Alias:DestinationContext
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DestTagCondition

Valfritt uttrycksuttryck för tagg för att kontrollera matchningsvillkoret på målbloben. Blobbegäran misslyckas när målblobtaggar inte matchar det angivna uttrycket. Se informationen i https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Anger att den här cmdleten skriver över målbloben utan att du uppmanas att bekräfta den.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PremiumPageBlobTier

Premium-sidblobnivå

Typ:PremiumPageBlobTier
Godkända värden:Unknown, P4, P6, P10, P20, P30, P40, P50, P60, P70, P80
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RehydratePriority

Blockera Blob RehydratePriority. Anger med vilken prioritet en arkiverad blob ska extraheras. Giltiga värden är Hög/Standard.

Typ:RehydratePriority
Godkända värden:Standard, High
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ServerTimeoutPerRequest

Anger tidsgränsen för tjänstsidan i sekunder för en begäran. Om det angivna intervallet förflutit innan tjänsten bearbetar begäran returnerar lagringstjänsten ett fel.

Typ:Nullable<T>[Int32]
Alias:ServerTimeoutPerRequestInSeconds
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SrcBlob

Anger namnet på källbloben.

Typ:String
Alias:SourceBlob
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SrcContainer

Anger namnet på källcontainern.

Typ:String
Alias:SourceContainer
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SrcDir

Anger ett CloudFileDirectory-objekt från Azure Storage-klientbiblioteket.

Typ:CloudFileDirectory
Alias:SourceDir
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SrcFile

Anger ett CloudFile-objekt från Azure Storage-klientbiblioteket. Du kan skapa den eller använda cmdleten Get-AzStorageFile.

Typ:CloudFile
Alias:SourceFile
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SrcFilePath

Anger källfilens relativa sökväg för källkatalogen eller källresursen.

Typ:String
Alias:SourceFilePath
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SrcShare

Anger ett CloudFileShare-objekt från Azure Storage-klientbiblioteket. Du kan skapa den eller använda Cmdleten Get-AzStorageShare.

Typ:CloudFileShare
Alias:SourceShare
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SrcShareName

Anger källresursens namn.

Typ:String
Alias:SourceShareName
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-StandardBlobTier

Blockblobnivå, giltiga värden är Frekvent/Lågfrekvent/Arkiv/Kall. Mer information finns i https://learn.microsoft.com/azure/storage/blobs/storage-blob-storage-tiers

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Tag

Blobtaggar

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TagCondition

Valfritt tagguttrycksuttryck för att kontrollera matchningsvillkoret på källbloben. Blobbegäran misslyckas när källblobtaggar inte matchar det angivna uttrycket. Se informationen i https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

CloudBlob

CloudBlobContainer

CloudFile

String

IStorageContext

Utdata

AzureStorageBlob