Share via

Get-AzureStorageBlob

  • Referenz
Modul:
Azure.Storage

Listet die Blobs in einem Container auf.

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

Get-AzureStorageBlob
   [[-Blob] <String>]
   [-Container] <String>
   [-IncludeDeleted]
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzureStorageBlob
   [-Prefix <String>]
   [-Container] <String>
   [-IncludeDeleted]
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet "Get-AzureStorageBlob " listet blob im angegebenen Container in einem Azure-Speicherkonto auf.

Beispiele

Beispiel 1: Abrufen eines Blobs nach Blobname

PS C:\>Get-AzureStorageBlob -Container "ContainerName" -Blob blob*

Dieser Befehl verwendet einen BLOB-Namen und ein Wild Karte um ein Blob abzurufen.

Beispiel 2: Abrufen von Blobs in einem Container mithilfe der Pipeline

PS C:\>Get-AzureStorageContainer -Name container* | Get-AzureStorageBlob -IncludeDeleted

   Container Uri: https://storageaccountname.blob.core.windows.net/container1

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime         IsDeleted 
----                 --------  ------          -----------                    ------------         ---------- ------------         --------- 
test1                BlockBlob 403116          application/octet-stream       2017-11-08 07:53:19Z            2017-11-08 08:19:32Z True      
test1                BlockBlob 403116          application/octet-stream       2017-11-08 09:00:29Z                                 True      
test2                BlockBlob 403116          application/octet-stream       2017-11-08 07:53:00Z                                 False

Dieser Befehl verwendet die Pipeline, um alle Blobs (einschließlich Blobs im Status "Gelöscht") in einem Container abzurufen.

Beispiel 3: Abrufen von Blobs nach Namenspräfix

PS C:\>Get-AzureStorageBlob -Container "ContainerName" -Prefix "blob"

Dieser Befehl verwendet ein Namenspräfix zum Abrufen von Blobs.

Beispiel 4: Auflisten von Blobs in mehreren Batches

PS C:\>$MaxReturn = 10000
PS C:\> $ContainerName = "abc"
PS C:\> $Total = 0
PS C:\> $Token = $Null
PS C:\> do
 {
     $Blobs = Get-AzureStorageBlob -Container $ContainerName -MaxCount $MaxReturn  -ContinuationToken $Token
     $Total += $Blobs.Count
     if($Blobs.Length -le 0) { Break;}
     $Token = $Blobs[$blobs.Count -1].ContinuationToken;
 }
 While ($Token -ne $Null)
PS C:\> Echo "Total $Total blobs in container $ContainerName"

In diesem Beispiel werden die Parameter "MaxCount " und "ContinuationToken " verwendet, um Azure Storage-Blobs in mehreren Batches auflisten zu können. Die ersten vier Befehle weisen Variablen Werte zu, die im Beispiel verwendet werden sollen. Der fünfte Befehl gibt eine Do-While-Anweisung an, die das Cmdlet Get-AzureStorageBlob verwendet, um Blobs abzurufen. Die Anweisung enthält das in der $Token Variable gespeicherte Fortsetzungstoken. $Token ändert den Wert, während die Schleife ausgeführt wird. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help About_Do. Der letzte Befehl verwendet den Befehl "Echo ", um die Summe anzuzeigen.

Parameter

-Blob

Gibt ein Namens- oder Namensmuster an, das für eine Wildsuche verwendet werden kann Karte. Wenn kein Blobname angegeben ist, listet das Cmdlet alle Blobs im angegebenen Container auf. Wenn für diesen Parameter ein Wert angegeben ist, listet das Cmdlet alle Blobs mit Namen auf, die diesem Parameter entsprechen.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Container

Gibt den Namen des Containers an.

Type:String
Aliases:N, Name
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Context

Gibt das Azure-Speicherkonto an, aus dem Sie eine Liste von Blobs abrufen möchten. Sie können das Cmdlet New-AzureStorageContext verwenden, um einen Speicherkontext zu erstellen.

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ContinuationToken

Gibt ein Fortsetzungstoken für die Blobliste an. Verwenden Sie diesen Parameter und den Parameter "MaxCount ", um Blobs in mehreren Batches auflisten zu können.

Type:BlobContinuationToken
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeDeleted

"Gelöschtes Blob einschließen", enthält standardmäßig "Blob abrufen" kein gelöschtes Blob.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxCount

Gibt die maximale Anzahl von Objekten an, die dieses Cmdlet zurückgibt.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Prefix

Gibt ein Präfix für die Blobnamen an, die Sie abrufen möchten. Dieser Parameter unterstützt nicht die Verwendung regulärer Ausdrücke oder Wild Karte Zeichen zum Durchsuchen. Wenn der Container nur Blobs mit dem Namen "My", "MyBlob1" und "MyBlob2" enthält und Sie "-Prefix My*" angeben, gibt das Cmdlet keine Blobs zurück. Wenn Sie jedoch "-Prefix My" angeben, gibt das Cmdlet "My", "MyBlob1" und "MyBlob2" zurück.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

String

IStorageContext

Ausgaben

AzureStorageBlob