Get-AzStorageBlobContent

Modul:

Az.Storage Module

Lädt ein Speicher-BLOB herunter.

Syntax

ReceiveManual (Standard)

Get-AzStorageBlobContent
    [-Blob] <String>
    [-Container] <String>
    [-Destination <String>]
    [-CheckMd5]
    [-Context <IStorageContext>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

BlobPipeline

Get-AzStorageBlobContent
    -CloudBlob <CloudBlob>
    [-BlobBaseClient <BlobBaseClient>]
    [-Destination <String>]
    [-CheckMd5]
    [-Context <IStorageContext>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ContainerPipeline

Get-AzStorageBlobContent
    [-Blob] <String>
    -CloudBlobContainer <CloudBlobContainer>
    [-Destination <String>]
    [-CheckMd5]
    [-Context <IStorageContext>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UriPipeline

Get-AzStorageBlobContent
    -AbsoluteUri <String>
    [-Destination <String>]
    [-Force]
    [-AsJob]
    [-TagCondition <String>]
    [-ServerTimeoutPerRequest <Int32>]
    [-ClientTimeoutPerRequest <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Cmdlet "Get-AzStorageBlobContent " lädt das angegebene Speicher-Blob herunter. Wenn der BLOB-Name für den lokalen Computer nicht gültig ist, wird er von diesem Cmdlet automatisch aufgelöst, wenn dies möglich ist.

Beispiele

Beispiel 1: Herunterladen von BLOB-Inhalten nach Name

Get-AzStorageBlobContent -Container "ContainerName" -Blob "Blob" -Destination "C:\test\"

Mit diesem Befehl wird ein BLOB anhand des Namens heruntergeladen.

Beispiel 2: Herunterladen von BLOB-Inhalten mithilfe der Pipeline

Get-AzStorageBlob -Container containername -Blob blobname | Get-AzStorageBlobContent

Dieser Befehl verwendet die Pipeline zum Suchen und Herunterladen von BLOB-Inhalten.

Beispiel 3: Herunterladen von BLOB-Inhalten mithilfe der Pipeline und eines Wildcardzeichens

Get-AzStorageContainer container* | Get-AzStorageBlobContent -Blob "cbox.exe" -Destination "C:\test"

In diesem Beispiel wird das Sternchen als Wildcardzeichen und die Pipeline zum Suchen und Herunterladen von BLOB-Inhalten verwendet.

Beispiel 4: Abrufen eines BLOB-Objekts und Speichern in einer Variablen und anschließendes Herunterladen von BLOB-Inhalten mit dem BLOB-Objekt

$blob = Get-AzStorageBlob -Container containername -Blob blobname
Get-AzStorageBlobContent -CloudBlob $blob.ICloudBlob -Destination "C:\test"

In diesem Beispiel wird zuerst ein BLOB-Objekt abgerufen und in einer Variablen gespeichert, und dann blob-Inhalt mit dem BLOB-Objekt heruntergeladen.

Beispiel 5: Herunterladen eines BLOB-Inhalts mit BLOB-URI

Get-AzStorageBlobContent -Uri $blobUri -Destination "C:\test" -Force

In diesem Beispiel wird ein BLOB-Inhalt mit URI heruntergeladen, der URI kann ein URI mit Sas-Token sein. Wenn sich das Blob auf einem verwalteten Datenträgerkonto befindet und der Server neben Sas Uri ein Bearertoken zum Herunterladen benötigt, versucht das Cmdlet, ein Bearertoken mit der vom Server zurückgegebenen Zielgruppe und den Anmeldeinformationen des AAD-Benutzers zu generieren, und lädt dann blob mit Sas URI und Bearertoken herunter.

Parameter

-AbsoluteUri

Blob-URI, von dem heruntergeladen werden soll.

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	Uri, BlobUri

Parametersätze

UriPipeline

Position:	Named
Obligatorisch:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-AsJob

Führen Sie das Cmdlet im Hintergrund aus.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Blob

Gibt den Namen des blobs an, das heruntergeladen werden soll.

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

ReceiveManual

Position:	0
Obligatorisch:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

ContainerPipeline

Position:	0
Obligatorisch:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-BlobBaseClient

BlobBaseClient-Objekt

Parametereigenschaften

Typ:	BlobBaseClient
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

BlobPipeline

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-CheckMd5

Gibt an, ob die Md5-Summe für die heruntergeladene Datei überprüft werden soll.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

ReceiveManual

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

BlobPipeline

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

ContainerPipeline

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	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.

Parametereigenschaften

Typ:	Nullable<T>[Int32]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	ClientTimeoutPerRequestInSeconds

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-CloudBlob

Gibt ein Cloud-Blob an. Verwenden Sie das Cmdlet Get-AzStorageBlob, um ein CloudBlob-Objekt abzurufen.

Parametereigenschaften

Typ:	Microsoft.Azure.Storage.Blob.CloudBlob
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	ICloudBlob

Parametersätze

BlobPipeline

Position:	Named
Obligatorisch:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-CloudBlobContainer

Gibt ein CloudBlobContainer - Objekt aus der Azure Storage-Clientbibliothek an. Sie können es erstellen oder das cmdlet Get-AzStorageContainer verwenden.

Parametereigenschaften

Typ:	Microsoft.Azure.Storage.Blob.CloudBlobContainer
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

ContainerPipeline

Position:	Named
Obligatorisch:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	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.

Parametereigenschaften

Typ:	Nullable<T>[Int32]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	False
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	vgl

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Container

Gibt den Namen des Containers an, der über das BLOB verfügt, das Sie herunterladen möchten.

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

ReceiveManual

Position:	1
Obligatorisch:	True
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Context

Gibt das Azure-Speicherkonto an, aus dem Sie Blob-Inhalte herunterladen möchten. Sie können das Cmdlet New-AzStorageContext verwenden, um einen Speicherkontext zu erstellen.

Parametereigenschaften

Typ:	IStorageContext
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

ReceiveManual

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	True
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

BlobPipeline

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	True
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

ContainerPipeline

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	True
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-DefaultProfile

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

Parametereigenschaften

Typ:	IAzureContextContainer
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	AzureRmContext, AzureCredential

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Destination

Gibt den Speicherort an, an dem die heruntergeladene Datei gespeichert werden soll.

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	Pfad

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Force

Überschreibt eine vorhandene Datei ohne Bestätigung.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	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.

Parametereigenschaften

Typ:	Nullable<T>[Int32]
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	ServerTimeoutPerRequestInSeconds

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	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 unter https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-WhatIf

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

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	False
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	Wi

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

Microsoft.Azure.Storage.Blob.CloudBlob

Microsoft.Azure.Storage.Blob.CloudBlobContainer

IStorageContext

Ausgaben

AzureStorageBlob

Hinweise

• Wenn der BLOB-Name für den lokalen Computer ungültig ist, wird er von diesem Cmdlet autoresolviert, sofern dies möglich ist.

Ähnliche Themen

• Set-AzStorageBlobContent
• Get-AzStorageBlob
• Remove-AzStorageBlob