Start-AzureStorageBlobCopy

Reference

Modul:: Azure.Storage

Začne kopírovat objekt blob.

Upozorňující

Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

Syntaxe

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

Rutina Start-AzureStorageBlobCopy začne kopírovat objekt blob.

Příklady

Příklad 1: Zkopírování pojmenovaného objektu blob

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

Tento příkaz spustí operaci kopírování objektu blob s názvem ContosoPlanning2015 z kontejneru s názvem ContosoUploads do kontejneru s názvem ContosoArchives.

Příklad 2: Získání kontejneru pro určení objektů blob pro kopírování

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

Tento příkaz získá kontejner s názvem ContosoUploads pomocí rutiny Get-AzureStorageContainer a pak kontejner předá aktuální rutině pomocí operátoru kanálu. Tato rutina spustí operaci kopírování objektu blob s názvem ContosoPlanning2015. Předchozí rutina poskytuje zdrojový kontejner. Parametr DestContainer určuje ContosoArchives jako cílový kontejner.

Příklad 3: Získání všech objektů blob v kontejneru a jejich zkopírování

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

Tento příkaz získá objekty blob v kontejneru s názvem ContosoUploads pomocí rutiny Get-AzureStorageBlob a výsledky pak předá aktuální rutině pomocí operátoru kanálu. Tato rutina spustí operaci kopírování objektů blob do kontejneru s názvem ContosoArchives.

Příklad 4: Zkopírování objektu blob určeného jako objekt

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

První příkaz získá objekt blob ContosoPlanning2015 v kontejneru s názvem ContosoUploads. Příkaz uloží tento objekt do proměnné $SrcBlob. Druhý příkaz získá objekt blob ContosoPlanning2015Archived v kontejneru s názvem ContosoArchives. Příkaz uloží tento objekt do proměnné $DestBlob. Poslední příkaz spustí operaci kopírování ze zdrojového kontejneru do cílového kontejneru. Příkaz používá standardní zápis tečky k určení objektů ICloudBlob pro $SrcBlob a $DestBlob objekty blob.

Příklad 5: Zkopírování objektu blob z identifikátoru URI

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

Tento příkaz vytvoří kontext pro účet ContosoGeneral, který používá zadaný klíč, a pak tento klíč uloží do proměnné $Context. Druhý příkaz zkopíruje soubor ze zadaného identifikátoru URI do objektu blob s názvem ContosoPlanning v kontejneru s názvem ContosoArchive. Příkaz spustí operaci kopírování v kontextu uloženém v $Context.

Parametry

-AbsoluteUri

Určuje absolutní identifikátor URI souboru, který se má zkopírovat do objektu blob služby Azure Storage.

Typ:	String
Aliasy:	SrcUri, SourceUri
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ClientTimeoutPerRequest

Určuje interval časového limitu na straně klienta v sekundách pro jednu žádost o službu. Pokud předchozí volání v zadaném intervalu selže, tato rutina požadavek opakuje. Pokud tato rutina neobdrží úspěšnou odpověď před uplynutím intervalu, vrátí tato rutina chybu.

Typ:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-CloudBlob

Určuje objekt CloudBlob z klientské knihovny služby Azure Storage. K získání objektu CloudBlob použijte rutinu Get-AzureStorageBlob.

Typ:	CloudBlob
Aliasy:	SrcICloudBlob, SrcCloudBlob, ICloudBlob, SourceICloudBlob, SourceCloudBlob
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-CloudBlobContainer

Určuje objekt CloudBlobContainer z klientské knihovny služby Azure Storage. Tato rutina zkopíruje objekt blob z kontejneru, který tento parametr určuje. K získání objektu CloudBlobContainer použijte rutinu Get-AzureStorageContainer.

Typ:	CloudBlobContainer
Aliasy:	SourceCloudBlobContainer
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ConcurrentTaskCount

Určuje maximální počet souběžných síťových volání. Pomocí tohoto parametru můžete omezit souběžnost na omezení využití místního procesoru a šířky pásma zadáním maximálního počtu souběžných síťových volání. Zadaná hodnota je absolutní počet a nevynásobí se počtem jader. Tento parametr může pomoct snížit problémy s připojením k síti v prostředích s nízkou šířkou pásma, například 100 kilobitů za sekundu. Výchozí hodnota je 10.

Typ:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Context

Určuje kontext úložiště Azure. K získání kontextu úložiště použijte rutinu New-AzureStorageContext.

Typ:	IStorageContext
Aliasy:	SrcContext, SourceContext
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Typ:	IAzureContextContainer
Aliasy:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DestBlob

Určuje název cílového objektu blob.

Typ:	String
Aliasy:	DestinationBlob
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DestCloudBlob

Určuje cílový objekt CloudBlob .

Typ:	CloudBlob
Aliasy:	DestICloudBlob, DestinationCloudBlob, DestinationICloudBlob
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DestContainer

Určuje název cílového kontejneru.

Typ:	String
Aliasy:	DestinationContainer
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-DestContext

Určuje kontext úložiště Azure. K získání kontextu úložiště použijte rutinu New-AzureStorageContext.

Typ:	IStorageContext
Aliasy:	DestinationContext
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Force

Označuje, že tato rutina přepíše cílový objekt blob bez výzvy k potvrzení.

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PremiumPageBlobTier

Úroveň objektu blob stránky Premium

Typ:	PremiumPageBlobTier
Přípustné hodnoty:	Unknown, P4, P6, P10, P20, P30, P40, P50, P60
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ServerTimeoutPerRequest

Určuje interval časového limitu na straně služby v sekundách pro požadavek. Pokud zadaný interval uplynou před tím, než služba zpracuje požadavek, služba úložiště vrátí chybu.

Typ:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SrcBlob

Určuje název zdrojového objektu blob.

Typ:	String
Aliasy:	SourceBlob
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SrcContainer

Určuje název zdrojového kontejneru.

Typ:	String
Aliasy:	SourceContainer
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SrcDir

Určuje objekt CloudFileDirectory z klientské knihovny služby Azure Storage.

Typ:	CloudFileDirectory
Aliasy:	SourceDir
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SrcFile

Specifikuje objekt CloudFile z klientské knihovny Azure Storage. Můžete ho vytvořit nebo použít rutinu Get-AzureStorageFile.

Typ:	CloudFile
Aliasy:	SourceFile
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-SrcFilePath

Určuje relativní cestu ke zdrojovému souboru zdrojového adresáře nebo zdrojové sdílené složky.

Typ:	String
Aliasy:	SourceFilePath
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SrcShare

Určuje objekt CloudFileShare z klientské knihovny služby Azure Storage. Můžete ho vytvořit nebo použít rutinu Get-AzureStorageShare.

Typ:	CloudFileShare
Aliasy:	SourceShare
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-SrcShareName

Určuje název zdrojové sdílené složky.

Typ:	String
Aliasy:	SourceShareName
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

CloudBlob

CloudBlobContainer

CloudFile

Parametry: SrcFile (ByValue)

String

IStorageContext

Výstupy

AzureStorageBlob

Sdílet prostřednictvím

Start-AzureStorageBlobCopy

Syntaxe

Description

Příklady

Příklad 1: Zkopírování pojmenovaného objektu blob

Příklad 2: Získání kontejneru pro určení objektů blob pro kopírování

Příklad 3: Získání všech objektů blob v kontejneru a jejich zkopírování

Příklad 4: Zkopírování objektu blob určeného jako objekt

Příklad 5: Zkopírování objektu blob z identifikátoru URI

Parametry

-AbsoluteUri

-ClientTimeoutPerRequest

-CloudBlob

-CloudBlobContainer

-ConcurrentTaskCount

-Confirm

-Context

-DefaultProfile

-DestBlob

-DestCloudBlob

-DestContainer

-DestContext

-Force

-PremiumPageBlobTier

-ServerTimeoutPerRequest

-SrcBlob

-SrcContainer

-SrcDir

-SrcFile

-SrcFilePath

-SrcShare

-SrcShareName

-WhatIf

Vstupy

Výstupy

Další materiály

Sdílet prostřednictvím

Start-AzureStorageBlobCopy

Syntaxe

Description

Příklady

Příklad 1: Zkopírování pojmenovaného objektu blob

Příklad 2: Získání kontejneru pro určení objektů blob pro kopírování

Příklad 3: Získání všech objektů blob v kontejneru a jejich zkopírování

Příklad 4: Zkopírování objektu blob určeného jako objekt

Příklad 5: Zkopírování objektu blob z identifikátoru URI

Parametry

-AbsoluteUri

-ClientTimeoutPerRequest

-CloudBlob

-CloudBlobContainer

-ConcurrentTaskCount

-Confirm

-Context

-DefaultProfile

-DestBlob

-DestCloudBlob

-DestContainer

-DestContext

-Force

-PremiumPageBlobTier

-ServerTimeoutPerRequest

-SrcBlob

-SrcContainer

-SrcDir

-SrcFile

-SrcFilePath

-SrcShare

-SrcShareName

-WhatIf

Vstupy

Výstupy

Související odkazy

Další materiály