Get-AzStorageBlob

Referens

Modul:: Az.Storage

Visar en lista över blobar i en container.

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

Cmdleten Get-AzStorageBlob listar blobar i den angivna containern i ett Azure Storage-konto.

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 kommandot Echo 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 enda blobhörn 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 blob-prTooperties 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.

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

-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]
Alias:	ClientTimeoutPerRequestInSeconds
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-AzStorageContext 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 parametern MaxCount för att lista 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

-IncludeTag

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

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

-IncludeVersion

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

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]
Alias:	ServerTimeoutPerRequestInSeconds
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-SnapshotTime

Blob SnapshotTime

Typ:	Nullable<T>[DateTimeOffset]
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	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://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations.

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

-VersionId

Blob VersionId

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

Indata

String

IStorageContext

Utdata

AzureStorageBlob

Dela via

Get-AzStorageBlob

Syntax

Description

Exempel

Exempel 1: Hämta en blob efter blobnamn

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

Exempel 3: Hämta blobar efter namnprefix

Exempel 4: Lista blobar i flera batchar

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

Exempel 6: Hämta en enskild blobversion

Exempel 7: Hämta en enskild blobögonblicksbild

Exempel 8: Hämta blob inkludera blobtaggar

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

Exempel 10: Hämta blobegenskaper (exempel: ImmutabilityPolicy) för en enskild blob

Parametrar

-Blob

-ClientTimeoutPerRequest

-ConcurrentTaskCount

-Container

-Context

-ContinuationToken

-DefaultProfile

-IncludeDeleted

-IncludeTag

-IncludeVersion

-MaxCount

-Prefix

-ServerTimeoutPerRequest

-SnapshotTime

-TagCondition

-VersionId

Indata

Utdata

Ytterligare resurser

Dela via

Get-AzStorageBlob

Syntax

Description

Exempel

Exempel 1: Hämta en blob efter blobnamn

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

Exempel 3: Hämta blobar efter namnprefix

Exempel 4: Lista blobar i flera batchar

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

Exempel 6: Hämta en enskild blobversion

Exempel 7: Hämta en enskild blobögonblicksbild

Exempel 8: Hämta blob inkludera blobtaggar

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

Exempel 10: Hämta blobegenskaper (exempel: ImmutabilityPolicy) för en enskild blob

Parametrar

-Blob

-ClientTimeoutPerRequest

-ConcurrentTaskCount

-Container

-Context

-ContinuationToken

-DefaultProfile

-IncludeDeleted

-IncludeTag

-IncludeVersion

-MaxCount

-Prefix

-ServerTimeoutPerRequest

-SnapshotTime

-TagCondition

-VersionId

Indata

Utdata

Relaterade länkar

Ytterligare resurser