Delen via

Get-AzureStorageBlob

  • Referentie
Module:
Azure.Storage

Hiermee geeft u een lijst met blobs in een container weer.

Waarschuwing

De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.

Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.

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

De cmdlet Get-AzureStorageBlob vermeldt blob in de opgegeven container in een Azure-opslagaccount.

Voorbeelden

Voorbeeld 1: Een blob ophalen op blobnaam

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

Deze opdracht maakt gebruik van een blobnaam en jokerteken om een blob op te halen.

Voorbeeld 2: Blobs in een container ophalen met behulp van de pijplijn

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

Met deze opdracht wordt de pijplijn gebruikt om alle blobs op te halen (inclusief blobs in de status Verwijderd) in een container.

Voorbeeld 3: Blobs ophalen op naamvoorvoegsel

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

Met deze opdracht wordt een naamvoorvoegsel gebruikt om blobs op te halen.

Voorbeeld 4: Blobs in meerdere batches vermelden

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 dit voorbeeld worden de parameters MaxCount en ContinuationToken gebruikt om Azure Storage-blobs in meerdere batches weer te geven. Met de eerste vier opdrachten worden waarden toegewezen aan variabelen die in het voorbeeld moeten worden gebruikt. De vijfde opdracht geeft een Do-While-instructie op die gebruikmaakt van de Get-AzureStorageBlob-cmdlet om blobs op te halen. De instructie bevat het vervolgtoken dat is opgeslagen in de $Token variabele. $Token de waarde wijzigt terwijl de lus wordt uitgevoerd. Typ voor meer informatie Get-Help About_Do. De laatste opdracht maakt gebruik van de echo-opdracht om het totaal weer te geven.

Parameters

-Blob

Hiermee geeft u een naam of naampatroon op, dat kan worden gebruikt voor een zoekopdracht met jokertekens. Als er geen blobnaam is opgegeven, geeft de cmdlet alle blobs in de opgegeven container weer. Als er een waarde is opgegeven voor deze parameter, geeft de cmdlet alle blobs weer met namen die overeenkomen met deze parameter.

Type:String
Position:0
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientTimeoutPerRequest

Hiermee geeft u het time-outinterval aan de clientzijde op, in seconden, voor één serviceaanvraag. Als de vorige aanroep mislukt in het opgegeven interval, probeert deze cmdlet de aanvraag opnieuw uit te voeren. Als deze cmdlet geen geslaagd antwoord ontvangt voordat het interval is verstreken, retourneert deze cmdlet een fout.

Type:Nullable<T>[Int32]
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-ConcurrentTaskCount

Hiermee geeft u het maximum aantal gelijktijdige netwerkaanroepen op. U kunt deze parameter gebruiken om de gelijktijdigheid te beperken om het lokale CPU- en bandbreedtegebruik te beperken door het maximum aantal gelijktijdige netwerkaanroepen op te geven. De opgegeven waarde is een absoluut aantal en wordt niet vermenigvuldigd met het aantal kernen. Deze parameter kan helpen bij het verminderen van netwerkverbindingsproblemen in omgevingen met lage bandbreedte, zoals 100 kilobits per seconde. De standaardwaarde is 10.

Type:Nullable<T>[Int32]
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Container

Hiermee geeft u de naam van de container.

Type:String
Aliases:N, Name
Position:1
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-Context

Hiermee geeft u het Azure-opslagaccount op waaruit u een lijst met blobs wilt ophalen. U kunt de cmdlet New-AzureStorageContext gebruiken om een opslagcontext te maken.

Type:IStorageContext
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ContinuationToken

Hiermee geeft u een vervolgtoken voor de bloblijst. Gebruik deze parameter en de parameter MaxCount om blobs in meerdere batches weer te geven.

Type:BlobContinuationToken
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-IncludeDeleted

Verwijderde blob opnemen, standaard wordt de verwijderde blob niet opgenomen.

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxCount

Hiermee geeft u het maximum aantal objecten op dat door deze cmdlet wordt geretourneerd.

Type:Nullable<T>[Int32]
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Prefix

Hiermee geeft u een voorvoegsel op voor de blobnamen die u wilt ophalen. Deze parameter biedt geen ondersteuning voor het gebruik van reguliere expressies of jokertekens om te zoeken. Dit betekent dat als de container alleen blobs met de naam 'My', 'MyBlob1' en 'MyBlob2' heeft en u '-Voorvoegsel Mijn*' opgeeft, de cmdlet geen blobs retourneert. Als u echter '-Voorvoegsel Mijn' opgeeft, retourneert de cmdlet 'Mijn', 'MyBlob1' en 'MyBlob2'.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-ServerTimeoutPerRequest

Hiermee geeft u het time-outinterval aan de servicezijde op, in seconden, voor een aanvraag. Als het opgegeven interval is verstreken voordat de service de aanvraag verwerkt, retourneert de opslagservice een fout.

Type:Nullable<T>[Int32]
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

String

IStorageContext

Uitvoerwaarden

AzureStorageBlob