Start-AzureStorageBlobCopy
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
Parametry: SrcFile (ByValue)