Get-AzStorageBlob

  • Referentie
Module:
Az.Storage

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

Syntax

Get-AzStorageBlob
   [[-Blob] <String>]
   [-Container] <String>
   [-IncludeDeleted]
   [-IncludeTag]
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageBlob
   [-Blob] <String>
   [-Container] <String>
   [-IncludeDeleted]
   [-IncludeTag]
   -SnapshotTime <DateTimeOffset>
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageBlob
   [-Blob] <String>
   [-Container] <String>
   [-IncludeDeleted]
   [-IncludeTag]
   -VersionId <String>
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-TagCondition <String>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]
Get-AzStorageBlob
   [-Prefix <String>]
   [-Container] <String>
   [-IncludeDeleted]
   [-IncludeVersion]
   [-IncludeTag]
   [-MaxCount <Int32>]
   [-ContinuationToken <BlobContinuationToken>]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Description

De Cmdlet Get-AzStorageBlob bevat blobs in de opgegeven container in een Azure-opslagaccount.

Voorbeelden

Voorbeeld 1: Een blob ophalen op blobnaam

Get-AzStorageBlob -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

Get-AzStorageContainer -Name container* | Get-AzStorageBlob -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

Get-AzStorageBlob -Container "ContainerName" -Prefix "blob"

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

Voorbeeld 4: Blobs in meerdere batches vermelden

$MaxReturn = 10000
$ContainerName = "abc"
$Total = 0
$Token = $Null
do
 {
     $Blobs = Get-AzStorageBlob -Container $ContainerName -MaxCount $MaxReturn  -ContinuationToken $Token
     $Total += $Blobs.Count
     if($Blobs.Length -le 0) { Break;}
     $Token = $Blobs[$blobs.Count -1].ContinuationToken;
 }
 While ($null -ne $Token)
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-AzStorageBlob-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.

Voorbeeld 5: alle blobs in een container opnemen in blobversie

Get-AzStorageBlob -Container "containername"  -IncludeVersion

AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
blob1                BlockBlob 2097152         application/octet-stream       2020-07-06 06:56:06Z Hot                                     False      2020-07-06T06:56:06.2432658Z  
blob1                BlockBlob 2097152         application/octet-stream       2020-07-06 06:56:06Z Hot        2020-07-06T06:56:06.8588431Z False                                    
blob1                BlockBlob 2097152         application/octet-stream       2020-07-06 06:56:06Z Hot                                     False      2020-07-06T06:56:06.8598431Z *  
blob2                BlockBlob 2097152         application/octet-stream       2020-07-03 16:19:16Z Hot                                     False      2020-07-03T16:19:16.2883167Z  
blob2                BlockBlob 2097152         application/octet-stream       2020-07-03 16:19:35Z Hot                                     False      2020-07-03T16:19:35.2381110Z *

Met deze opdracht worden alle blobs in een container opgenomen blobversie.

Voorbeeld 6: Een enkele blobversie ophalen

Get-AzStorageBlob -Container "containername" -Blob blob2 -VersionId "2020-07-03T16:19:16.2883167Z"

AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
blob2                BlockBlob 2097152         application/octet-stream       2020-07-03 16:19:16Z Hot                                     False      2020-07-03T16:19:16.2883167Z

Met deze opdracht krijgt u één blobs-verion met VersionId.

Voorbeeld 7: Een momentopname van één blob ophalen

Get-AzStorageBlob -Container "containername" -Blob blob1 -SnapshotTime "2020-07-06T06:56:06.8588431Z"

AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
blob1                BlockBlob 2097152         application/octet-stream       2020-07-06 06:56:06Z Hot        2020-07-06T06:56:06.8588431Z False

Met deze opdracht krijgt u één momentopname van blobs met SnapshotTime.

Voorbeeld 8: Blob-tags ophalen

$blobs = Get-AzStorageBlob -Container "containername" -IncludeTag

$blobs

   AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
testblob             BlockBlob 2097152         application/octet-stream       2020-07-23 09:35:02Z Hot                                     False      2020-07-23T09:35:02.8527357Z *
testblob2            BlockBlob 2097152         application/octet-stream       2020-07-23 09:35:04Z Hot                                     False      2020-07-23T09:35:04.0856187Z *


$blobs[0].Tags
Name          Value 
----          -----
tag1          value1
tag2          value2

Met deze opdracht worden blobs uit een container met blobtags weergegeven en worden de tags van de eerste blob weergegeven.

Voorbeeld 9: Een enkele blob ophalen met een blobtagvoorwaarde

Get-AzStorageBlob -Container "containername" -Blob testblob -TagCondition """tag1""='value1'"

AccountName: storageaccountname, ContainerName: containername

Name                 BlobType  Length          ContentType                    LastModified         AccessTier SnapshotTime                 IsDeleted  VersionId                     
----                 --------  ------          -----------                    ------------         ---------- ------------                 ---------  ---------                     
testblob             BlockBlob 2097152         application/octet-stream       2020-07-23 09:35:02Z Hot                                     False      2020-07-23T09:35:02.8527357Z *

Met deze opdracht krijgt u één blob met een blobtagvoorwaarde. De cmdlet wordt alleen uitgevoerd wanneer de blob een tag bevat met de naam 'tag1' en de waarde 'value1', anders mislukt de cmdlet met foutcode 412.

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. Deze parameter ondersteunt jokertekens overal in de tekenreeks.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:True

-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]
Aliases:ClientTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required: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
Default value:None
Required: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
Default value:None
Required: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-AzStorageContext gebruiken om een opslagcontext te maken.

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

-IncludeDeleted

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

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

-IncludeTag

Blobtags opnemen, standaard worden blobtags niet opgenomen.

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

-IncludeVersion

Blob-versies worden alleen weergegeven als deze parameter aanwezig is. Standaard bevat get-blob geen blobversies.

Type:SwitchParameter
Position:Named
Default value:None
Required: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
Default value:None
Required: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
Default value:None
Required: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]
Aliases:ServerTimeoutPerRequestInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SnapshotTime

Blob SnapshotTime

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

-TagCondition

Optionele tagexpressie-instructie om overeenkomstvoorwaarde te controleren. De blobaanvraag mislukt wanneer de blobtags niet overeenkomen met de opgegeven expressie. Zie voor details https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

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

-VersionId

Blob VersionId

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

Invoerwaarden

String

IStorageContext

Uitvoerwaarden

AzureStorageBlob