Start-AzureStorageBlobCopy

Referenz

Modul:: Azure.Storage

Startet das Kopieren eines Blobs.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

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

Beschreibung

Das Start-AzureStorageBlobCopy-Cmdlet beginnt mit dem Kopieren eines Blobs.

Beispiele

Beispiel 1: Kopieren eines benannten Blobs

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

Mit diesem Befehl wird der Kopiervorgang des Blobs "ContosoPlanning2015" aus dem Container "ContosoUploads" in den Container "ContosoArchives" gestartet.

Beispiel 2: Abrufen eines Containers zum Angeben von zu kopierenden Blobs

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

Dieser Befehl ruft den Container "ContosoUploads" mithilfe des Cmdlets "Get-AzureStorageContainer " ab und übergibt dann den Container mithilfe des Pipelineoperators an das aktuelle Cmdlet. Dieses Cmdlet startet den Kopiervorgang des Blobs "ContosoPlanning2015". Das vorherige Cmdlet stellt den Quellcontainer bereit. Der Parameter DestContainer gibt ContosoArchives als Zielcontainer an.

Beispiel 3: Abrufen aller Blobs in einem Container und Kopieren

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

Dieser Befehl ruft die Blobs im Container "ContosoUploads" mithilfe des Cmdlets "Get-AzureStorageBlob " ab und übergibt dann die Ergebnisse mithilfe des Pipelineoperators an das aktuelle Cmdlet. Mit diesem Cmdlet wird der Kopiervorgang der Blobs in den Container "ContosoArchives" gestartet.

Beispiel 4: Kopieren eines blobs, das als Objekt angegeben ist

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

Der erste Befehl ruft den Blob "ContosoPlanning2015" im Container mit dem Namen "ContosoUploads" ab. Der Befehl speichert dieses Objekt in der variablen $SrcBlob. Der zweite Befehl ruft den Blob "ContosoPlanning2015Archived" im Container "ContosoArchives" ab. Der Befehl speichert dieses Objekt in der $DestBlob Variablen. Der letzte Befehl startet den Kopiervorgang aus dem Quellcontainer in den Zielcontainer. Der Befehl verwendet die standardmäßige Punktnotation, um die ICloudBlob-Objekte für die $SrcBlob und $DestBlob Blobs anzugeben.

Beispiel 5: Kopieren eines Blobs aus einem 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

Dieser Befehl erstellt einen Kontext für das Konto "ContosoGeneral", das den angegebenen Schlüssel verwendet, und speichert diesen Schlüssel dann in der variablen $Context. Der zweite Befehl kopiert die Datei aus dem angegebenen URI in den Blob "ContosoPlanning" im Container "ContosoArchive". Der Befehl startet den Kopiervorgang im Kontext, der in $Context gespeichert ist.

Parameter

-AbsoluteUri

Gibt den absoluten URI einer Datei an, die in ein Azure Storage-Blob kopiert werden soll.

Typ:	String
Aliase:	SrcUri, SourceUri
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-ClientTimeoutPerRequest

Gibt das clientseitige Timeoutintervall in Sekunden für eine Serviceanfrage an. Wenn der vorherige Aufruf im angegebenen Intervall fehlschlägt, führt dieses Cmdlet die Anforderung erneut aus. Wenn dieses Cmdlet vor Ablauf des Intervalls keine erfolgreiche Antwort erhält, gibt dieses Cmdlet einen Fehler zurück.

Typ:	Nullable<T>[Int32]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-CloudBlob

Gibt ein CloudBlob-Objekt aus der Azure Storage Client-Bibliothek an. Verwenden Sie das Cmdlet "Get-AzureStorageBlob", um ein CloudBlob-Objekt abzurufen.

Typ:	CloudBlob
Aliase:	SrcICloudBlob, SrcCloudBlob, ICloudBlob, SourceICloudBlob, SourceCloudBlob
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-CloudBlobContainer

Gibt ein CloudBlobContainer -Objekt aus der Azure Storage-Clientbibliothek an. Dieses Cmdlet kopiert einen BLOB aus dem Container, den dieser Parameter angibt. Verwenden Sie das Cmdlet Get-AzureStorageContainer, um ein CloudBlobContainer-Objekt abzurufen.

Typ:	CloudBlobContainer
Aliase:	SourceCloudBlobContainer
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-ConcurrentTaskCount

Gibt die maximalen gleichzeitigen Netzwerkanrufe an. Mit diesem Parameter können Sie die Parallelität einschränken, um die lokale CPU- und Bandbreitenauslastung zu drosseln, indem Sie die maximale Anzahl gleichzeitiger Netzwerkanrufe angeben. Der angegebene Wert ist eine absolute Anzahl und wird nicht mit der Kernanzahl multipliziert. Dieser Parameter kann dazu beitragen, Netzwerkverbindungsprobleme in Umgebungen mit geringer Bandbreite zu reduzieren, z. B. 100 Kilobit pro Sekunde. Der Standardwert ist 10.

Typ:	Nullable<T>[Int32]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Context

Gibt einen Azure-Speicherkontext an. Verwenden Sie zum Abrufen eines Speicherkontexts das Cmdlet New-AzureStorageContext.

Typ:	IStorageContext
Aliase:	SrcContext, SourceContext
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:	IAzureContextContainer
Aliase:	AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DestBlob

Gibt den Namen des Ziel-BLOB an.

Typ:	String
Aliase:	DestinationBlob
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DestCloudBlob

Gibt ein CloudBlob-Zielobjekt an.

Typ:	CloudBlob
Aliase:	DestICloudBlob, DestinationCloudBlob, DestinationICloudBlob
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DestContainer

Gibt den Namen des Zielcontainers an.

Typ:	String
Aliase:	DestinationContainer
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DestContext

Gibt einen Azure-Speicherkontext an. Verwenden Sie zum Abrufen eines Speicherkontexts das Cmdlet New-AzureStorageContext.

Typ:	IStorageContext
Aliase:	DestinationContext
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Force

Gibt an, dass dieses Cmdlet das Ziel-BLOB überschreibt, ohne Dass Sie zur Bestätigung aufgefordert werden.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PremiumPageBlobTier

Premium-Seiten-BLOB-Ebene

Typ:	PremiumPageBlobTier
Zulässige Werte:	Unknown, P4, P6, P10, P20, P30, P40, P50, P60
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ServerTimeoutPerRequest

Gibt das Dienstseitige Timeoutintervall in Sekunden für eine Anforderung an. Wenn das angegebene Intervall verstrichen ist, bevor der Dienst die Anforderung verarbeitet, gibt der Speicherdienst einen Fehler zurück.

Typ:	Nullable<T>[Int32]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SrcBlob

Gibt den Namen des Quell-BLOB an.

Typ:	String
Aliase:	SourceBlob
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SrcContainer

Gibt den Namen des Quellcontainers an.

Typ:	String
Aliase:	SourceContainer
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SrcDir

Gibt ein CloudFileDirectory -Objekt aus der Azure Storage Client-Bibliothek an.

Typ:	CloudFileDirectory
Aliase:	SourceDir
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SrcFile

Gibt ein CloudFile-Objekt aus der Azure Storage Client-Bibliothek an. Sie können es erstellen oder das Cmdlet Get-AzureStorageFile verwenden.

Typ:	CloudFile
Aliase:	SourceFile
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-SrcFilePath

Gibt den relativen Pfad der Quelldatei des Quellverzeichnisses oder der Quellfreigabe an.

Typ:	String
Aliase:	SourceFilePath
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SrcShare

Gibt ein CloudFileShare-Objekt aus der Azure Storage Client-Bibliothek an. Sie können es erstellen oder das Cmdlet Get-AzureStorageShare verwenden.

Typ:	CloudFileShare
Aliase:	SourceShare
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SrcShareName

Gibt den Namen der Quellfreigabe an.

Typ:	String
Aliase:	SourceShareName
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

CloudBlob

CloudBlobContainer

CloudFile

Parameter: SrcFile (ByValue)

String

IStorageContext

Ausgaben

AzureStorageBlob

Freigeben über

Start-AzureStorageBlobCopy

Syntax

Beschreibung

Beispiele

Beispiel 1: Kopieren eines benannten Blobs

Beispiel 2: Abrufen eines Containers zum Angeben von zu kopierenden Blobs

Beispiel 3: Abrufen aller Blobs in einem Container und Kopieren

Beispiel 4: Kopieren eines blobs, das als Objekt angegeben ist

Beispiel 5: Kopieren eines Blobs aus einem URI

Parameter

-AbsoluteUri

-ClientTimeoutPerRequest

-CloudBlob

-CloudBlobContainer

-ConcurrentTaskCount

-Confirm

-Context

-DefaultProfile

-DestBlob

-DestCloudBlob

-DestContainer

-DestContext

-Force

-PremiumPageBlobTier

-ServerTimeoutPerRequest

-SrcBlob

-SrcContainer

-SrcDir

-SrcFile

-SrcFilePath

-SrcShare

-SrcShareName

-WhatIf

Eingaben

Ausgaben

Zusätzliche Ressourcen

Freigeben über

Start-AzureStorageBlobCopy

Syntax

Beschreibung

Beispiele

Beispiel 1: Kopieren eines benannten Blobs

Beispiel 2: Abrufen eines Containers zum Angeben von zu kopierenden Blobs

Beispiel 3: Abrufen aller Blobs in einem Container und Kopieren

Beispiel 4: Kopieren eines blobs, das als Objekt angegeben ist

Beispiel 5: Kopieren eines Blobs aus einem URI

Parameter

-AbsoluteUri

-ClientTimeoutPerRequest

-CloudBlob

-CloudBlobContainer

-ConcurrentTaskCount

-Confirm

-Context

-DefaultProfile

-DestBlob

-DestCloudBlob

-DestContainer

-DestContext

-Force

-PremiumPageBlobTier

-ServerTimeoutPerRequest

-SrcBlob

-SrcContainer

-SrcDir

-SrcFile

-SrcFilePath

-SrcShare

-SrcShareName

-WhatIf

Eingaben

Ausgaben

Ähnliche Themen

Zusätzliche Ressourcen