Start-AzStorageBlobCopy
Startet das Kopieren eines Blobs.
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>]
Beschreibung
Das Start-AzStorageBlobCopy-Cmdlet beginnt mit dem Kopieren eines Blobs.
Beispiele
Beispiel 1: Kopieren eines benannten Blobs
Start-AzStorageBlobCopy -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
Get-AzStorageContainer -Name "ContosoUploads" | Start-AzStorageBlobCopy -SrcBlob "ContosoPlanning2015" -DestContainer "ContosoArchives"
Mit diesem Befehl wird der Container "ContosoUploads" mithilfe des Cmdlets "Get-AzStorageContainer " abgerufen und anschließend mithilfe des Pipelineoperators an das aktuelle Cmdlet übergeben. 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
Get-AzStorageBlob -Container "ContosoUploads" | Start-AzStorageBlobCopy -DestContainer "ContosoArchives"
Dieser Befehl ruft die Blobs im Container "ContosoUploads" mithilfe des Cmdlets "Get-AzStorageBlob " 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
$SrcBlob = Get-AzStorageBlob -Container "ContosoUploads" -Blob "ContosoPlanning2015"
$DestBlob = Get-AzStorageBlob -Container "ContosoArchives" -Blob "ContosoPlanning2015Archived"
Start-AzStorageBlobCopy -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
$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
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 in den Zielkontext, der in $Context gespeichert ist. Es gibt keinen Quellspeicherkontext, sodass der Quell-URI Zugriff auf das Quellobjekt haben muss. Wenn es sich bei der Quelle um ein öffentliches Azure-Blob handelt, sollte der URI SAS-Token enthalten, das Lesezugriff auf das Blob hat.
Beispiel 6: Kopieren eines Block-Blobs in zielcontainer mit einem neuen Blobnamen und Festlegen des Ziel-Blob StandardBlobTier als Hot, RehydratePriority als hoch
Start-AzStorageBlobCopy -SrcContainer "ContosoUploads" -SrcBlob "BlockBlobName" -DestContainer "ContosoArchives" -DestBlob "NewBlockBlobName" -StandardBlobTier Hot -RehydratePriority High
Mit diesem Befehl wird der Kopiervorgang eines Block-BLOB-zu-Zielcontainers mit einem neuen BLOB-Namen gestartet und Ziel-Blob StandardBlobTier als Hot, RehydratePriority als Hoch festgelegt.
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 |
-BlobBaseClient
BlobBaseClient-Objekt
Typ: | BlobBaseClient |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
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] |
Aliase: | ClientTimeoutPerRequestInSeconds |
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-AzStorageBlob", 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-AzStorageContainer", 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-AzStorageContext.
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-AzStorageContext.
Typ: | IStorageContext |
Aliase: | DestinationContext |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-DestTagCondition
Optionale Tag-Ausdrucksanweisung zum Überprüfen der Übereinstimmungsbedingung für das Ziel-BLOB. Die BLOB-Anforderung schlägt fehl, wenn die Ziel-BLOB-Tags nicht mit dem angegebenen Ausdruck übereinstimmen. Weitere Informationen finden Sie in https://video2.skills-academy.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.
Typ: | String |
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, P70, P80 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-RehydratePriority
Blob RehydratePriority blockieren. Gibt die Priorität an, mit der ein archiviertes Blob rehydratiert werden soll. Gültige Werte sind "Hoch/Standard".
Typ: | RehydratePriority |
Zulässige Werte: | Standard, High |
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] |
Aliase: | ServerTimeoutPerRequestInSeconds |
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-AzStorageFile 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-AzStorageShare 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 |
-StandardBlobTier
Block Blob Tier, gültige Werte sind Hot/Cool/Archive/Cold. Details anzeigen in https://video2.skills-academy.com/azure/storage/blobs/storage-blob-storage-tiers
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Tag
Blob-Tags
Typ: | Hashtable |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-TagCondition
Optional tag expression statement to check match condition on the source blob. Die BLOB-Anforderung schlägt fehl, wenn die Quell-BLOB-Tags nicht mit dem angegebenen Ausdruck übereinstimmen. Weitere Informationen finden Sie in https://video2.skills-academy.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
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 |