Dela via

Get-AzureStorageBlob

  • Referens
Modul:
Azure.Storage

Visar en lista över blobar i en container.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

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>]

Description

Cmdleten Get-AzureStorageBlob visar en lista över blobar i den angivna containern i ett Azure-lagringskonto.

Exempel

Exempel 1: Hämta en blob efter blobnamn

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

Det här kommandot använder ett blobnamn och jokertecken för att hämta en blob.

Exempel 2: Hämta blobar i en container med hjälp av pipelinen

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

Det här kommandot använder pipelinen för att hämta alla blobar (inkludera blobar i Borttagen status) i en container.

Exempel 3: Hämta blobar efter namnprefix

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

Det här kommandot använder ett namnprefix för att hämta blobar.

Exempel 4: Lista blobar i flera batchar

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"

I det här exemplet används parametrarna MaxCount och ContinuationToken för att lista Azure Storage-blobar i flera batchar. De första fyra kommandona tilldelar värden till variabler som ska användas i exemplet. Det femte kommandot anger en Do-While-instruktion som använder cmdleten Get-AzureStorageBlob för att hämta blobar. -instruktionen innehåller fortsättningstoken som lagras i variabeln $Token. $Token ändrar värdet när loopen körs. Om du vill ha mer information skriver du Get-Help About_Do. Det sista kommandot använder Echo-kommandot för att visa summan.

Parametrar

-Blob

Anger ett namn- eller namnmönster som kan användas för en jokerteckensökning. Om inget blobnamn anges visar cmdleten alla blobar i den angivna containern. Om ett värde anges för den här parametern listar cmdleten alla blobar med namn som matchar den här parametern.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ClientTimeoutPerRequest

Anger tidsgränsen på klientsidan i sekunder för en tjänstbegäran. Om det föregående anropet misslyckas i det angivna intervallet försöker den här cmdleten skicka begäran igen. Om den här cmdleten inte får något lyckat svar innan intervallet förflutit returnerar den här cmdleten ett fel.

Typ:Nullable<T>[Int32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ConcurrentTaskCount

Anger maximalt antal samtidiga nätverksanrop. Du kan använda den här parametern för att begränsa samtidigheten för att begränsa den lokala processor- och bandbreddsanvändningen genom att ange det maximala antalet samtidiga nätverksanrop. Det angivna värdet är ett absolut antal och multipliceras inte med kärnantalet. Den här parametern kan bidra till att minska problem med nätverksanslutningar i miljöer med låg bandbredd, till exempel 100 kilobit per sekund. Standardvärdet är 10.

Typ:Nullable<T>[Int32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Container

Anger namnet på containern.

Typ:String
Alias:N, Name
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Context

Anger det Azure Storage-konto som du vill hämta en lista över blobar från. Du kan använda cmdleten New-AzureStorageContext för att skapa en lagringskontext.

Typ:IStorageContext
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ContinuationToken

Anger en fortsättningstoken för bloblistan. Använd den här parametern och MaxCount-parametern för att visa blobar i flera batchar.

Typ:BlobContinuationToken
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IncludeDeleted

Inkludera borttagen blob, som standard innehåller hämta blob inte borttagen blob.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MaxCount

Anger det maximala antalet objekt som den här cmdleten returnerar.

Typ:Nullable<T>[Int32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Prefix

Anger ett prefix för de blobnamn som du vill hämta. Den här parametern stöder inte sökning med reguljära uttryck eller jokertecken. Det innebär att om containern bara har blobar med namnet "My", "MyBlob1" och "MyBlob2" och du anger "-Prefix My*", returnerar cmdleten inga blobar. Men om du anger "-Prefix My" returnerar cmdleten "My", "MyBlob1" och "MyBlob2".

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ServerTimeoutPerRequest

Anger tidsgränsen för tjänstsidan i sekunder för en begäran. Om det angivna intervallet förflutit innan tjänsten bearbetar begäran returnerar lagringstjänsten ett fel.

Typ:Nullable<T>[Int32]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String

IStorageContext

Utdata

AzureStorageBlob