Delen via

Get-AzStorageBlob

Module:
Az.Storage Module

Een lijst met blobs in een container.

Syntaxis

BlobName (Standaard) 

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

SingleBlobSnapshotTime 

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

SingleBlobVersionID 

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

BlobPrefix 

Get-AzStorageBlob
    [-Container] <String>
    [-Prefix <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-versie 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.

Voorbeeld 10: Blob-eigenschappen ophalen (voorbeeld: ImmutabilityPolicy) van één blob

$blobProperties = (Get-AzStorageBlob -Container "ContainerName" -Blob "blob" -Context $ctx).BlobProperties
$blobProperties.ImmutabilityPolicy

ExpiresOn                   PolicyMode
---------                   ----------
9/17/2024 2:49:32 AM +00:00   Unlocked

Met deze voorbeeldopdracht wordt de onveranderbaarheidseigenschap van één blob ophaalt. U kunt een gedetailleerde lijst met blobeigenschappen ophalen uit de eigenschap BlobProperties , waaronder maar niet beperkt tot: LastModified, ContentLength, ContentHash, BlobType, LeaseState, AccessTier, ETag, ImmutabilityPolicy, enzovoort... Als u meerdere blobs wilt weergeven (voer de cmdlet zonder blobnaam uit), gebruikt u ListBlobProperties.Properties in plaats van BlobProperties voor betere prestaties.

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.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

BlobName
Position:0
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

Nullable<T>[Int32]

Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ClientTimeoutPerRequestInSeconds

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

Nullable<T>[Int32]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Container

Hiermee geeft u de naam van de container.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:N, Naam

Parametersets

(All)
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:IStorageContext
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:Microsoft.Azure.Storage.Blob.BlobContinuationToken
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

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

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-IncludeDeleted

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-IncludeTag

Blobtags opnemen, standaard worden blobtags niet opgenomen.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-IncludeVersion

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

BlobPrefix
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-MaxCount

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

Parametereigenschappen

Type:

Nullable<T>[Int32]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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'.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

BlobPrefix
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten: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.

Parametereigenschappen

Type:

Nullable<T>[Int32]

Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:ServerTimeoutPerRequestInSeconds

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-SnapshotTime

Blob SnapshotTime

Parametereigenschappen

Type:

Nullable<T>[DateTimeOffset]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SingleBlobSnapshotTime
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-TagCondition

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

BlobName
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
SingleBlobSnapshotTime
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
SingleBlobVersionID
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-VersionId

Blob VersionId

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

SingleBlobVersionID
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

IStorageContext

Uitvoerwaarden

AzureStorageBlob