Get-AzDataLakeGen2ChildItem

Referens

Modul:: Az.Storage

Visar en lista över underkataloger och filer från en katalog eller filsystemrot.

Syntax

Get-AzDataLakeGen2ChildItem
   [-FileSystem] <String>
   [[-Path] <String>]
   [-FetchProperty]
   [-Recurse]
   [-MaxCount <Int32>]
   [-ContinuationToken <String>]
   [-AsJob]
   [-OutputUserPrincipalName]
   [-Context <IStorageContext>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Cmdleten Get-AzDataLakeGen2ChildItem visar en lista över underkataloger och filer i en katalog eller filsystem i ett Azure-lagringskonto. Den här cmdleten fungerar bara om hierarkisk namnrymd är aktiverad för lagringskontot. Den här typen av konto kan skapas genom att köra cmdleten "New-AzStorageAccount" med "-EnableHierarchicalNamespace $true".

Exempel

Exempel 1: Visa en lista över direktunderobjekt från ett filsystem

Get-AzDataLakeGen2ChildItem -FileSystem "filesystem1"

FileSystem Name: filesystem1

Path                 IsDirectory  Length          LastModified         Permissions  Owner                Group               
----                 -----------  ------          ------------         -----------  -----                -----               
dir1                 True                         2020-03-13 13:07:34Z rwxr-x---    $superuser           $superuser          
dir2                 True                         2020-03-23 09:28:36Z rwxr-x---    $superuser           $superuser

Det här kommandot visar en lista över direktunderobjekt från ett filsystem

Exempel 2: Lista rekursivt från en katalog och hämta egenskaper/ACL

Get-AzDataLakeGen2ChildItem -FileSystem "filesystem1" -Path "dir1/" -Recurse -FetchProperty

FileSystem Name: filesystem1

Path                 IsDirectory  Length          LastModified         Permissions  Owner                Group               
----                 -----------  ------          ------------         -----------  -----                -----               
dir1/dir3            True                         2020-03-23 09:34:31Z rwx---rwx    $superuser           $superuser          
dir1/file1           False        1024            2020-03-23 09:29:18Z rwx---rwx    $superuser           $superuser           
dir1/testfile_1K_0   False        1024            2020-03-23 09:29:21Z rw-r-----    $superuser           $superuser

Det här kommandot visar en lista över direktunderobjekt från ett filsystem

Exempel 3: Lista objekt rekursivt från ett filsystem i flera batchar

$MaxReturn = 1000
$FileSystemName = "filesystem1"
$Total = 0
$Token = $Null
do
 {
     $items = Get-AzDataLakeGen2ChildItem -FileSystem $FileSystemName -Recurse -MaxCount $MaxReturn  -ContinuationToken $Token
     $Total += $items.Count
     if($items.Length -le 0) { Break;}
     $Token = $items[$items.Count -1].ContinuationToken;
 }
 While ($null -ne $Token)
Echo "Total $Total items in Filesystem $FileSystemName"

I det här exemplet används parametrarna MaxCount och ContinuationToken för att visa objekt rekursivt från ett filsystem i flera batchar. Ett litet MaxCount kan begränsa antalet objekt som returneras från en enskild requst, kan hjälpa till vid tidsgränsfel för åtgärden och begränsa minnesanvändningen för Powershell. 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-AzDataLakeGen2ChildItem för att visa objekt. -instruktionen innehåller fortsättningstoken som lagras i variabeln $Token. $Token ändrar värdet när loopen körs. Det sista kommandot använder Echo-kommandot för att visa summan.

Parametrar

-AsJob

Kör cmdlet i bakgrunden

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

-Context

Azure Storage-kontextobjekt

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

-ContinuationToken

Fortsättningstoken.

Typ:	String
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

-FetchProperty

Hämta egenskaperna för datalake-objektet och ACL.

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

-FileSystem

FileSystem-namn

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

-MaxCount

Det maximala antalet blobar som kan returneras.

Typ:	Nullable<T>[Int32]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-OutputUserPrincipalName

Om den här parametern speicifieras omvandlas de användaridentitetsvärden som returneras i ägar- och gruppfälten för varje listpost från Microsoft Entra-objekt-ID:t till Användarens huvudnamn. Om den här parametern inte speicifieras returneras värdena som Microsoft Entra-objekt-ID:er. Observera att grupp- och programobjekt-ID:er inte översätts eftersom de inte har unika egna namn.

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

-Path

Sökvägen i det angivna filsystemet som ska hämtas. Bör vara en katalog i formatet "directory1/directory2/".

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

-Recurse

Anger om hämtar det underordnade objektet rekursivt. Standardvärdet är falskt.

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

Indata

String

IStorageContext

Utdata

AzureDataLakeGen2Item

Dela via