Get-AzStorageBlob
A tárolóban lévő blobokat listázza.
Syntax
BlobName (Alapértelmezett)
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
A Get-AzStorageBlob parancsmag egy Azure Storage-fiók megadott tárolójában lévő blobokat sorolja fel.
Példák
1. példa: Blob lekérése blobnév alapján
Get-AzStorageBlob -Container "ContainerName" -Blob blob*
Ez a parancs blobnevet és helyettesítő karaktert használ a blob lekéréséhez.
2. példa: Blobok lekérése egy tárolóban a folyamat használatával
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
Ez a parancs a folyamat használatával lekéri az összes blobot (a törölt állapotú blobokat is belefoglalva) egy tárolóba.
3. példa: Blobok lekérése névelőtag alapján
Get-AzStorageBlob -Container "ContainerName" -Prefix "blob"
Ez a parancs névelőtagot használ a blobok lekéréséhez.
4. példa: Blobok listázása több kötegben
$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"
Ez a példa a MaxCount és a ContinuationToken paraméterekkel listázza az Azure Storage-blobokat több kötegben.
Az első négy parancs értékeket rendel a példában használandó változókhoz.
Az ötödik parancs egy Do-While utasítást ad meg, amely a Get-AzStorageBlob parancsmagot használja a blobok lekéréséhez.
Az utasítás tartalmazza a $Token változóban tárolt folytatási jogkivonatot.
$Token a ciklus futtatásakor módosítja az értéket.
További információkért írja be a következőt Get-Help About_Do:
Az utolsó parancs az Echo paranccsal jeleníti meg a végösszeget.
5. példa: A tárolóban lévő összes blob lekérése blobverzióval
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 *
Ez a parancs lekéri a tárolóban lévő összes blobot, például blobverziót.
6. példa: Egyetlen blobverzió lekérése
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
Ez a parancs egyetlen blobverziót kap a VersionId azonosítóval.
7. példa: Egyetlen blob pillanatképének lekérése
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
Ez a parancs egyetlen blob-pillanatképet kap a SnapshotTime használatával.
8. példa: Blobok lekérése blobcímkék használatával
$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
Ez a parancs blobcímkéket tartalmazó tárolóból származó blobokat sorol fel, és megjeleníti az első blob címkéinek megjelenítését.
9. példa: Egyetlen blob lekérése blobcímkével
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 *
Ez a parancs egyetlen blobot kap blobcímkével.
A parancsmag csak akkor lesz sikeres, ha a blob tartalmaz egy "tag1" nevű és "value1" értékű címkét, különben a parancsmag a 412-s hibakóddal hiúsul meg.
10. példa: Egyetlen blob blobtulajdonságainak lekérése (például: ImmutabilityPolicy)
$blobProperties = (Get-AzStorageBlob -Container "ContainerName" -Blob "blob" -Context $ctx).BlobProperties
$blobProperties.ImmutabilityPolicy
ExpiresOn PolicyMode
--------- ----------
9/17/2024 2:49:32 AM +00:00 Unlocked
Ez a példaparancs egyetlen blob nem módosítható tulajdonságát kapja meg. A blobtulajdonságok részletes listáját a BlobProperties tulajdonságból szerezheti be, többek között a következőkre: LastModified, ContentLength, ContentHash, BlobType, LeaseState, AccessTier, ETag, ImmutabilityPolicy stb. Ha több blobot szeretne listázni (a parancsmagot blobnév nélkül szeretné végrehajtani), használja a ListBlobProperties.Properties függvényt a BlobProperties helyett a jobb teljesítmény érdekében.
Paraméterek
-Blob
Megadja a helyettesítő karakterek kereséséhez használható nevet vagy névmintát.
Ha nincs megadva blobnév, a parancsmag felsorolja a megadott tárolóban lévő összes blobot.
Ha egy érték van megadva ehhez a paraméterhez, a parancsmag felsorolja az összes olyan blobot, amelynek neve megegyezik ezzel a paraméterrel. Ez a paraméter a karakterlánc bármely pontján támogatja a helyettesítő karaktereket.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: True DontShow: False
Paraméterkészletek
BlobName
Position: 0 Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-ClientTimeoutPerRequest
Egy szolgáltatáskérés ügyféloldali időtúllépési időközét adja meg másodpercben.
Ha az előző hívás a megadott időközönként meghiúsul, a parancsmag újrapróbálkozza a kérést.
Ha ez a parancsmag nem kap sikeres választ az időköz eltelte előtt, ez a parancsmag hibát ad vissza.
Paramétertulajdonságok
Típus: Nullable<T> [ Int32 ]
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False Aliasok: ClientTimeoutPerRequestInSeconds
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-ConcurrentTaskCount
Az egyidejű hálózati hívások maximális száma.
Ezzel a paramétersel korlátozhatja az egyidejűséget a helyi processzor- és sávszélesség-használat szabályozására az egyidejű hálózati hívások maximális számának megadásával.
A megadott érték abszolút szám, és nem szorozza meg a magok számával.
Ez a paraméter segíthet csökkenteni a hálózati csatlakozási problémákat alacsony sávszélességű környezetekben, például másodpercenként 100 kilobitben.
Az alapértelmezett érték 10.
Paramétertulajdonságok
Típus: Nullable<T> [ Int32 ]
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-Container
Megadja a tároló nevét.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False Aliasok: N, Név
Paraméterkészletek
(All)
Position: 1 Kötelező: True Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: True Fennmaradó argumentumokból származó érték: False
-Context
Megadja azt az Azure Storage-fiókot, amelyből le szeretné kapni a blobok listáját.
A New-AzStorageContext parancsmaggal tárkörnyezetet hozhat létre.
Paramétertulajdonságok
Típus: IStorageContext
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: True Folyamatból származó érték tulajdonságnév alapján: True Fennmaradó argumentumokból származó érték: False
-ContinuationToken
A bloblista folytatási jogkivonatát adja meg.
Ezt a paramétert és a MaxCount paramétert használva listázhatja a blobokat több kötegben.
Paramétertulajdonságok
Típus: Microsoft.Azure.Storage.Blob.BlobContinuationToken
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.
Paramétertulajdonságok
Típus: IAzureContextContainer
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False Aliasok: AzureRmContext, AzureCredential
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-IncludeDeleted
A törölt blobok belefoglalása alapértelmezés szerint a get blob nem tartalmazza a törölt blobot.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-IncludeTag
Blobcímkék belefoglalása, a blobok beolvasása alapértelmezés szerint nem tartalmazza a blobcímkéket.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-IncludeVersion
A blobverziók csak akkor lesznek felsorolva, ha ez a paraméter jelen van, alapértelmezés szerint a get blob nem tartalmazza a blobverziókat.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
BlobPrefix
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-MaxCount
Meghatározza a parancsmag által visszaadott objektumok maximális számát.
Paramétertulajdonságok
Típus: Nullable<T> [ Int32 ]
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-Prefix
Megadja a lekérni kívánt blobnevek előtagjait.
Ez a paraméter nem támogatja a reguláris kifejezések vagy helyettesítő karakterek keresését.
Ez azt jelenti, hogy ha a tárolóban csak "My", "MyBlob1" és "MyBlob2" nevű blobok vannak, és a "-Prefix My*" értéket adja meg, a parancsmag nem ad vissza blobokat.
Ha azonban a "-Prefix My" értéket adja meg, a parancsmag a "My", a "MyBlob1" és a "MyBlob2" értéket adja vissza.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
BlobPrefix
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-ServerTimeoutPerRequest
A szolgáltatásoldali időtúllépési időközt adja meg másodpercben egy kéréshez.
Ha a megadott időköz el nem telik, mielőtt a szolgáltatás feldolgozza a kérést, a tárolási szolgáltatás hibát ad vissza.
Paramétertulajdonságok
Típus: Nullable<T> [ Int32 ]
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False Aliasok: ServerTimeoutPerRequestInSeconds
Paraméterkészletek
(All)
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-SnapshotTime
Blob SnapshotTime
Paramétertulajdonságok
Paraméterkészletek
SingleBlobSnapshotTime
Position: Named Kötelező: True Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-TagCondition
Nem kötelező címkekifejezési utasítás az egyezés feltételének ellenőrzéséhez.
A blobkérés sikertelen lesz, ha a blobcímkék nem felelnek meg a megadott kifejezésnek.
Részletek a következőben találhatók: https://learn.microsoft.com/en-us/rest/api/storageservices/specifying-conditional-headers-for-blob-service-operations#tags-conditional-operations .
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
BlobName
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
SingleBlobSnapshotTime
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
SingleBlobVersionID
Position: Named Kötelező: False Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
-VersionId
Blob verzióazonosítója
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None Támogatja a helyettesítő karaktereket: False DontShow: False
Paraméterkészletek
SingleBlobVersionID
Position: Named Kötelező: True Folyamatból származó érték: False Folyamatból származó érték tulajdonságnév alapján: False Fennmaradó argumentumokból származó érték: False
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters .
Kimenetek