Freigeben über

Set-AzureStorageBlobContent

  • Referenz
Modul:
Azure.Storage

Lädt eine lokale Datei in ein Azure Storage-Blob hoch.

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 weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

Set-AzureStorageBlobContent
   [-File] <String>
   [-Container] <String>
   [-Blob <String>]
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureStorageBlobContent
   [-File] <String>
   [-Blob <String>]
   -CloudBlobContainer <CloudBlobContainer>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzureStorageBlobContent
   [-File] <String>
   -CloudBlob <CloudBlob>
   [-BlobType <String>]
   [-Properties <Hashtable>]
   [-Metadata <Hashtable>]
   [-PremiumPageBlobTier <PremiumPageBlobTier>]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzureStorageBlobContent lädt eine lokale Datei in ein Azure Storage-Blob hoch.

Beispiele

Beispiel 1: Hochladen einer benannten Datei

PS C:\>Set-AzureStorageBlobContent -Container "ContosoUpload" -File ".\PlanningData" -Blob "Planning2015"

Mit diesem Befehl wird die Datei mit dem Namen PlanningData in ein Blob namens Planning2015 hochgeladen.

Beispiel 2: Hochladen aller Dateien unter dem aktuellen Ordner

PS C:\>Get-ChildItem -File -Recurse | Set-AzureStorageBlobContent -Container "ContosoUploads"

Dieser Befehl verwendet das zentrale Windows PowerShell-Cmdlet Get-ChildItem, um alle Dateien im aktuellen Ordner und in Unterordnern abzurufen, und übergibt sie dann mithilfe des Pipelineoperators an das aktuelle Cmdlet. Das Cmdlet Set-AzureStorageBlobContent lädt die Dateien in den Container "ContosoUploads" hoch.

Beispiel 3: Überschreiben eines vorhandenen Blobs

PS C:\>Get-AzureStorageBlob -Container "ContosoUploads" -Blob "Planning2015" | Set-AzureStorageBlobContent -File "ContosoPlanning"

Mit diesem Befehl wird der Blob "Planning2015" im Container "ContosoUploads" mithilfe des Cmdlets "Get-AzureStorageBlob" abgerufen und anschließend an das aktuelle Cmdlet übergeben. Der Befehl lädt die Datei mit dem Namen ContosoPlanning als Planning2015 hoch. Dieser Befehl gibt den Parameter Force nicht an. Die Eingabeaufforderung fordert Sie zur Bestätigung auf. Wenn Sie den Befehl bestätigen, überschreibt das Cmdlet das vorhandene Blob.

Beispiel 4: Hochladen einer Datei in einen Container mithilfe der Pipeline

PS C:\>Get-AzureStorageContainer -Container "ContosoUpload*" | Set-AzureStorageBlobContent -File "ContosoPlanning" -Blob "Planning2015"

Dieser Befehl ruft den Container ab, der mit der Zeichenfolge "ContosoUpload" beginnt, mithilfe des Cmdlets "Get-AzureStorageContainer " und übergibt diesen Blob dann an das aktuelle Cmdlet. Der Befehl lädt die Datei mit dem Namen ContosoPlanning als Planning2015 hoch.

Beispiel 5: Hochladen einer Datei in seiten-BLOB mit Metadaten und PremiumPageBlobTier als P10

PS C:\>$Metadata = @{"key" = "value"; "name" = "test"}
PS C:\> Set-AzureStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Metadata $Metadata -BlobType Page -PremiumPageBlobTier P10

Der erste Befehl erstellt eine Hashtabelle, die Metadaten für ein Blob enthält, und speichert diese Hashtabelle in der $Metadata Variablen. Der zweite Befehl lädt die Datei namens ContosoPlanning in den Container "ContosoUploads" hoch. Das Blob enthält die in $Metadata gespeicherten Metadaten und hat PremiumPageBlobTier als P10.

Beispiel 6: Hochladen einer Datei in blob mit angegebenen BLOB-Eigenschaften

PS C:\> Set-AzureStorageBlobContent -File "ContosoPlanning" -Container "ContosoUploads" -Properties @{"ContentType" = "image/jpeg"; "ContentMD5" = "i727sP7HigloQDsqadNLHw=="}

Mit diesem Befehl wird die Datei mit dem Namen "ContosoPlanning" in den Container "ContosoUploads" mit angegebenen BLOB-Eigenschaften hochgeladen.

Parameter

-Blob

Gibt den Namen eines Blobs an. Dieses Cmdlet lädt eine Datei in das Azure Storage-Blob hoch, das dieser Parameter angibt.

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

-BlobType

Gibt den Typ für den Blob an, den dieses Cmdlet hochlädt. Zulässige Werte für diesen Parameter:

  • Blockieren
  • Seite Der Standardwert ist "Block".
Typ:String
Zulässige Werte:Block, Page, Append
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
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 an. Verwenden Sie das Cmdlet "Get-AzureStorageBlob", um ein CloudBlob-Objekt abzurufen.

Typ:CloudBlob
Aliase:ICloudBlob
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 lädt Inhalt in einen Blob im Container hoch, den dieser Parameter angibt. Verwenden Sie das Cmdlet Get-AzureStorageContainer, um ein CloudBlobContainer-Objekt abzurufen.

Typ:CloudBlobContainer
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

-Container

Gibt den Namen eines Containers an. Dieses Cmdlet lädt eine Datei in einen BLOB im Container hoch, den dieser Parameter angibt.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Context

Gibt einen Azure-Speicherkontext an. Verwenden Sie zum Abrufen eines Speicherkontexts das Cmdlet New-AzureStorageContext. Um einen Speicherkontext zu verwenden, der aus einem SAS-Token ohne Leseberechtigung erstellt wurde, müssen Sie "-Force"-Parameter hinzufügen, um die Blob-Existenz zu überspringen.

Typ:IStorageContext
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

-File

Gibt einen lokalen Dateipfad für eine Datei an, die als BLOB-Inhalt hochgeladen werden soll.

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

-Force

Gibt an, dass dieses Cmdlet ein vorhandenes Blob überschreibt, ohne Dass Sie zur Bestätigung aufgefordert werden.

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

-Metadata

Gibt Metadaten für das hochgeladene Blob an.

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

-PremiumPageBlobTier

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

-Properties

Gibt Eigenschaften für das hochgeladene BLOB an. Die unterstützten Eigenschaften sind: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType.

Typ:Hashtable
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

-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

String

CloudBlobContainer

CloudBlob

IStorageContext

Ausgaben

AzureStorageBlob