Get-AzDataLakeGen2ChildItem

Modul:
Az.Storage Module

Vypíše podadresáři a soubory z adresáře nebo kořenového adresáře systému souborů.

Syntax

Default (Výchozí) 

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

Description

Rutina Get-AzDataLakeGen2ChildItem obsahuje seznam podadresáře a souborů v adresáři nebo systému souborů v účtu úložiště Azure. Tato rutina funguje jenom v případě, že je pro účet úložiště povolený hierarchický obor názvů. Tento druh účtu je možné vytvořit spuštěním rutiny New-AzStorageAccount s $true -EnableHierarchicalNamespace.

Příklady

Příklad 1: Výpis přímých dílčích položek ze systému souborů

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

Tento příkaz zobrazí seznam přímých dílčích položek ze systému souborů.

Příklad 2: Rekurzivně vypsat z adresáře a načíst vlastnosti/seznam 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

Tento příkaz zobrazí seznam přímých dílčích položek ze systému souborů.

Příklad 3: Rekurzivní výpis položek ze systému souborů ve více dávkách

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

Tento příklad používá parametry MaxCount a ContinuationToken k rekurzivnímu výpisu položek ze systému souborů v několika dávkách. Malý MaxCount může omezit počet položek vrácených z jednoho požadavku, může pomoct zabránit chybám časového limitu operace a snížit využití paměti PowerShellu. První čtyři příkazy přiřazují hodnoty proměnným, které se mají použít v příkladu. Pátý příkaz určuje příkaz Do-While , který používá rutinu Get-AzDataLakeGen2ChildItem k výpisu položek. Příkaz obsahuje token pokračování uložený v proměnné $Token. $Token se při spuštění smyčky změní hodnota. Poslední příkaz použije příkaz Echo k zobrazení součtu.

Parametry

-AsJob

Spuštění rutiny na pozadí

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Context

kontextový objekt Azure Storage

Vlastnosti parametru

Typ:IStorageContext
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-ContinuationToken

Token pokračování

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Vlastnosti parametru

Typ:IAzureContextContainer
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:AzureRmContext, AzureCredential

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-FetchProperty

Načtěte vlastnosti položky datalake a seznam ACL.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Načtenípermission

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-FileSystem

Název systému souborů

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:0
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-MaxCount

Maximální počet objektů blob, které se můžou vrátit.

Vlastnosti parametru

Typ:

Nullable<T>[Int32]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-OutputUserPrincipalName

Pokud tento parametr zadáte, hodnoty identity uživatele vrácené v polích vlastníka a skupiny jednotlivých položek seznamu se transformují z id objektů Microsoft Entra na hlavní názvy uživatelů. Pokud tento parametr nezadáte, vrátí se hodnoty jako id objektů Microsoft Entra. Všimněte si, že ID objektů skupiny a aplikace se nepřekládají, protože nemají jedinečné popisné názvy.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Hlavní jméno uživatele

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Path

Cesta v zadaném systému souborů, která by se měla načíst. Měl by to být adresář ve formátu directory1/directory2/.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:1
Povinné:False
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Recurse

Označuje, jestli se podřízená položka rekurzivně získá. Výchozí hodnota je false.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

IStorageContext

Výstupy

AzureDataLakeGen2Item