Set-AzStorageBlobContent
Lädt eine lokale Datei in ein Azure Storage-Blob hoch.
Syntax
Set-AzStorageBlobContent
[-File] <String>
[-Container] <String>
[-Blob <String>]
[-BlobType <String>]
[-Properties <Hashtable>]
[-Metadata <Hashtable>]
[-Tag <Hashtable>]
[-PremiumPageBlobTier <PremiumPageBlobTier>]
[-StandardBlobTier <String>]
[-EncryptionScope <String>]
[-Force]
[-AsJob]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzStorageBlobContent
[-File] <String>
[-Blob <String>]
-CloudBlobContainer <CloudBlobContainer>
[-BlobType <String>]
[-Properties <Hashtable>]
[-Metadata <Hashtable>]
[-Tag <Hashtable>]
[-PremiumPageBlobTier <PremiumPageBlobTier>]
[-StandardBlobTier <String>]
[-EncryptionScope <String>]
[-Force]
[-AsJob]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzStorageBlobContent
[-File] <String>
-CloudBlob <CloudBlob>
[-BlobType <String>]
[-Properties <Hashtable>]
[-Metadata <Hashtable>]
[-Tag <Hashtable>]
[-PremiumPageBlobTier <PremiumPageBlobTier>]
[-StandardBlobTier <String>]
[-EncryptionScope <String>]
[-Force]
[-AsJob]
[-TagCondition <String>]
[-Context <IStorageContext>]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Set-AzStorageBlobContent lädt eine lokale Datei in ein Azure Storage-Blob hoch.
Beispiele
Beispiel 1: Hochladen einer benannten Datei
Set-AzStorageBlobContent -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
Get-ChildItem -File -Recurse | Set-AzStorageBlobContent -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-AzStorageBlobContent lädt die Dateien in den Container "ContosoUploads" hoch.
Beispiel 3: Überschreiben eines vorhandenen Blobs
Get-AzStorageBlob -Container "ContosoUploads" -Blob "Planning2015" | Set-AzStorageBlobContent -File "ContosoPlanning"
Mit diesem Befehl wird der Blob "Planning2015" im Container "ContosoUploads" mithilfe des Cmdlets "Get-AzStorageBlob" 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
Get-AzStorageContainer -Container "ContosoUpload*" | Set-AzStorageBlobContent -File "ContosoPlanning" -Blob "Planning2015"
Dieser Befehl ruft den Container ab, der mit der Zeichenfolge "ContosoUpload" beginnt, mithilfe des Cmdlets "Get-AzStorageContainer " 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
$Metadata = @{"key" = "value"; "name" = "test"}
Set-AzStorageBlobContent -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 und Festlegen von StandardBlobTier als Cool
$filepath = "c:\temp\index.html"
Set-AzStorageBlobContent -File $filepath -Container "contosouploads" -Properties @{"ContentType" = [System.Web.MimeMapping]::GetMimeMapping($filepath); "ContentMD5" = "i727sP7HigloQDsqadNLHw=="} -StandardBlobTier Cool
AccountName: storageaccountname, ContainerName: contosouploads
Name BlobType Length ContentType LastModified AccessTier SnapshotTime IsDeleted VersionId
---- -------- ------ ----------- ------------ ---------- ------------ --------- ---------
index.html BlockBlob 403116 text/html 2020-09-22 08:06:53Z Cool False
Mit diesem Befehl wird die Datei "c:\temp\index.html" in den Container mit dem Namen "contosouploads" mit angegebenen BLOB-Eigenschaften hochgeladen und "StandardBlobTier" als Cool festgelegt. Mit diesem Befehl wird der ContentType-Wert abgerufen, der auf Blobeigenschaften durch [System.Web.MimeMapping]::GetMimeMapping() API festgelegt ist.
Beispiel 7: Hochladen einer Datei in ein Blob mit Verschlüsselungsbereich
$blob = Set-AzStorageBlobContent -File "mylocalfile" -Container "mycontainer" -Blob "myblob" -EncryptionScope "myencryptscope"
$blob.BlobProperties.EncryptionScope
myencryptscope
Mit diesem Befehl wird eine Datei in ein BLOB mit Verschlüsselungsbereich hochgeladen.
Parameter
-AsJob
Führen Sie das Cmdlet im Hintergrund aus.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-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
- Anfügen
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] |
Aliase: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-CloudBlob
Gibt ein CloudBlob -Objekt an. Verwenden Sie das Cmdlet "Get-AzStorageBlob", 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-AzStorageContainer", 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-AzStorageContext. Um einen speicherbezogenen Kontext zu verwenden, der aus einem SAS-Token ohne Leseberechtigung erstellt wurde, müssen Sie den Parameter "-Force" 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 |
-EncryptionScope
Verschlüsselungsbereich, der beim Senden von Anforderungen an das Blob verwendet werden soll.
Typ: | String |
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, P70, P80 |
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] |
Aliase: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
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
Optionale Tag-Ausdrucksanweisung zum Überprüfen der Übereinstimmungsbedingung. Die BLOB-Anforderung schlägt fehl, wenn die Blobtags 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 |