Get-AzDataLakeGen2ChildItem

  • Referencia
Modul:
Az.Storage

Az alkönyvtárakat és fájlokat listázza egy könyvtárból vagy fájlrendszergyökérből.

Syntax

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

Description

A Get-AzDataLakeGen2ChildItem parancsmag egy Azure Storage-fiók címtárában vagy fájlrendszerében található alkönyvtárakat és fájlokat sorolja fel. Ez a parancsmag csak akkor működik, ha a hierarchikus névtér engedélyezve van a Tárfiókhoz. Ez a fióktípus a "New-AzStorageAccount" parancsmag "-EnableHierarchicalNamespace $true" parancsmaggal hozható létre.

Példák

1. példa: A fájlrendszerből származó közvetlen alelemek listázása

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

Ez a parancs a fájlrendszerből származó közvetlen alelemeket sorolja fel

2. példa: Lista rekurzív módon egy könyvtárból, és tulajdonságok/ACL beolvasása

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

Ez a parancs a fájlrendszerből származó közvetlen alelemeket sorolja fel

3. példa: Elemek rekurzív listázása egy fájlrendszerből több kötegben

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

Ez a példa a MaxCount és a ContinuationToken paraméterek használatával rekurzívan listázza az elemeket egy fájlrendszerből több kötegben. Egy kis MaxCount korlátozhatja az egyetlen requstból visszaadott elemeket, segíthet a művelet időtúllépési hibájában, és korlátozhatja a PowerShell memóriahasználatát. 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-AzDataLakeGen2ChildItem parancsmagot használja az elemek listázásához. 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. Az utolsó parancs az Echo paranccsal jeleníti meg a végösszeget.

Paraméterek

-AsJob

Parancsmag futtatása a háttérben

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Context

Azure Storage környezeti objektum

Type:IStorageContext
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ContinuationToken

Folytatási jogkivonat.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FetchProperty

Kérje le az adatlake-elem tulajdonságait és az ACL-t.

Type:SwitchParameter
Aliases:FetchPermission
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FileSystem

Fájlrendszer neve

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaxCount

A visszaadható blobok maximális száma.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OutputUserPrincipalName

Ha ezt a paramétert írja be, az egyes listabejegyzések tulajdonos- és csoportmezőiben visszaadott felhasználói identitásértékek a Microsoft Entra Objektumazonosítókból egyszerű felhasználónevekké alakulnak át. Ha nem írja be ezt a paramétert, az értékek Microsoft Entra objektumazonosítóként lesznek visszaadva. Vegye figyelembe, hogy a csoport- és alkalmazásobjektum-azonosítók nincsenek lefordítva, mert nem rendelkeznek egyedi felhasználóbarát névvel.

Type:SwitchParameter
Aliases:UserPrincipalName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

A lekérendő megadott fájlrendszer elérési útja. Könyvtárnak kell lennie, "directory1/directory2/" formátumban.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Recurse

Azt jelzi, hogy rekurzívan lekéri-e a gyermekelemet. Az alapértelmezett érték hamis.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

String

IStorageContext

Kimenetek

AzureDataLakeGen2Item