Dela via

Get-AzStorageBlob

Modul:
Az.Storage Module

Visar en lista över blobar i en container.

Syntax

BlobName (Standard) 

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

Cmdleten Get-AzStorageBlob visar blobar i den angivna containern i ett Azure-lagringskonto.

Exempel

Exempel 1: Hämta en blob efter blobnamn

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

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

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

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

$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"

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

Exempel 5: Hämta alla blobar i en container inkluderar blobversion

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 *

Det här kommandot hämtar alla blobar i en container med blobversion.

Exempel 6: Hämta en enskild blobversion

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

Det här kommandot hämtar en enskild blobversion med VersionId.

Exempel 7: Hämta en enskild blobögonblicksbild

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

Det här kommandot hämtar en ögonblicksbild av enskilda blobar med SnapshotTime.

Exempel 8: Hämta blob inkludera blobtaggar

$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

Det här kommandot listar blobar från en container med blobtaggar och visar taggarna för den första bloben.

Exempel 9: Hämta en enskild blob med blobtaggens villkor

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 *

Det här kommandot hämtar en enda blob med blobtaggens villkor. Cmdleten lyckas bara när bloben innehåller en tagg med namnet "tag1" och värdet "value1", annars misslyckas cmdleten med felkoden 412.

Exempel 10: Hämta blobegenskaper (exempel: ImmutabilityPolicy) för en enskild 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

Det här exempelkommandot hämtar egenskapen oföränderlighet för en enskild blob. Du kan hämta en detaljerad lista över blobegenskaper från egenskapen BlobProperties , inklusive men inte begränsat till: LastModified, ContentLength, ContentHash, BlobType, LeaseState, AccessTier, ETag, ImmutabilityPolicy osv. Om du vill visa en lista över flera blobar (köra cmdleten utan blobnamn) använder du ListBlobProperties.Properties i stället för BlobProperties för bättre prestanda.

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. Den här parametern stöder jokertecken var som helst i strängen.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

BlobName
Position:0
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:ClientTimeoutPerRequestInSeconds

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Container

Anger namnet på containern.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:N, Namn

Parameteruppsättningar

(All)
Position:1
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Context

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

Parameteregenskaper

Typ:IStorageContext
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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.

Parameteregenskaper

Typ:Microsoft.Azure.Storage.Blob.BlobContinuationToken
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

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

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-IncludeDeleted

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-IncludeTag

Inkludera blobtaggar. Hämta blob innehåller som standard inte blobtaggar.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-IncludeVersion

Blobversioner visas endast om den här parametern finns, som standard innehåller inte hämta blob-versioner.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

BlobPrefix
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-MaxCount

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

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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".

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

BlobPrefix
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument: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.

Parameteregenskaper

Typ:

Nullable<T>[Int32]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:ServerTimeoutPerRequestInSeconds

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SnapshotTime

Blob SnapshotTime

Parameteregenskaper

Typ:

Nullable<T>[DateTimeOffset]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SingleBlobSnapshotTime
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-TagCondition

Valfritt uttrycksuttryck för tagg för att kontrollera matchningsvillkoret. Blobbegäran misslyckas när blobtaggar inte matchar det angivna uttrycket. Se information i https://free.blessedness.top/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

BlobName
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
SingleBlobSnapshotTime
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False
SingleBlobVersionID
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-VersionId

Blob VersionId

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SingleBlobVersionID
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

IStorageContext

Utdata

AzureStorageBlob