New-AzDataLakeGen2Item

Modul:

Az.Storage Module

Vytvořte soubor nebo adresář v systému souborů.

Syntax

File (Výchozí)

New-AzDataLakeGen2Item
    [-FileSystem] <String>
    [-Path] <String>
    -Source <String>
    [-Umask <String>]
    [-Permission <String>]
    [-EncryptionContext <String>]
    [-Property <Hashtable>]
    [-Metadata <Hashtable>]
    [-Force]
    [-AsJob]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Directory

New-AzDataLakeGen2Item
    [-FileSystem] <String>
    [-Path] <String>
    [-Directory]
    [-Umask <String>]
    [-Permission <String>]
    [-Property <Hashtable>]
    [-Metadata <Hashtable>]
    [-Force]
    [-AsJob]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [-ConcurrentTaskCount <Int32>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Rutina New-AzDataLakeGen2Item vytvoří soubor nebo adresář v 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: Vytvoření adresáře se zadaným oprávněním, Umask, vlastnostmi a metadaty

New-AzDataLakeGen2Item -FileSystem "testfilesystem" -Path "dir1/dir2/" -Directory -Permission rwxrwxrwT -Umask ---rw---- -Property @{"CacheControl" = "READ"; "ContentDisposition" = "True"} -Metadata  @{"tag1" = "value1"; "tag2" = "value2" }

FileSystem Name: filesystem1

Path                 IsDirectory  Length          LastModified         Permissions  Owner                Group
----                 -----------  ------          ------------         -----------  -----                -----
dir1/dir2            True                         2020-03-23 09:15:56Z rwx---rwT    $superuser           $superuser

Tento příkaz vytvoří adresář se zadaným oprávněním, Umask, vlastnostmi a metadaty.

Příklad 2: Vytvoření (nahrání) souboru Data Lake z místního zdrojového souboru a rutina se spustí na pozadí.

$task = New-AzDataLakeGen2Item  -FileSystem "testfilesystem" -Path "dir1/dir2/file1" -Source "c:\sourcefile.txt" -Force -asjob
$task | Wait-Job
$task.Output

FileSystem Name: filesystem1

Path                 IsDirectory  Length          LastModified         Permissions  Owner                Group
----                 -----------  ------          ------------         -----------  -----                -----
dir1/dir2/file1      False        14400000        2020-03-23 09:19:13Z rw-r-----    $superuser           $superuser

Tento příkaz vytvoří (nahraje) soubor Data Lake z místního zdrojového souboru a rutina se spustí na pozadí.

Příklad 3: Vytvoření (nahrání) souboru Data Lake z místního zdrojového souboru a nastavení kontextu šifrování

$file = New-AzDataLakeGen2Item -FileSystem "testfilesystem" -Path "dir1/dir2/file1" -Source "c:\sourcefile.txt" -EncryptionContext "encryptioncontext"
$file.Properties.EncryptionContext

encryptioncontext

Tento příkaz vytvoří (nahrát) soubor Data Lake z místního zdrojového souboru a nastaví jeho hodnotu kontextu šifrování na "encryptioncontext".

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

-ConcurrentTaskCount

Celkový počet souběžných asynchronních úloh. Výchozí hodnota je 10.

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

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

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

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

-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

-Directory

Označuje, že tato nová položka je adresář, nikoli soubor.

Vlastnosti parametru

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

Sady parametrů

Directory

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

-EncryptionContext

Kontext šifrování souboru. Kontext šifrování je metadata, která nejsou při uložení v souboru šifrovaná. Primární aplikací tohoto pole je ukládání nešifrovaných dat, která lze použít k odvození klíče poskytnutého zákazníkem pro soubor. Neplatí pro adresáře.

Vlastnosti parametru

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

Sady parametrů

File

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

-Force

Pokud se předá, vytvoří se nová položka bez výzvy.

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

-Metadata

Určuje metadata pro vytvořený adresář nebo soubor.

Vlastnosti parametru

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

-Path

Cesta v zadaném systému souborů, který by se měl vytvořit. Může to být soubor nebo adresář ve formátu adresář/file.txtnebo directory1/directory2/.

Vlastnosti parametru

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

Sady parametrů

(All)

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

-Permission

Nastaví přístupová oprávnění POSIX pro vlastníka souboru, skupinu vlastníka souboru a další. Každé třídě může být uděleno oprávnění ke čtení, zápisu nebo spuštění. Podporuje se symbolický symbol (rwxrw-rw-). Bit sticky je také podporován a jeho znázornění písmenem t nebo T v konečném znaku v závislosti na tom, zda je spouštěcí bit pro ostatní kategorie nastaven nebo je nenastavený, absence t nebo T indikuje nenastavený bit.

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

-Property

Určuje vlastnosti vytvořeného adresáře nebo souboru. Podporované vlastnosti souboru jsou: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType. Podporované vlastnosti adresáře jsou: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage.

Vlastnosti parametru

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

-Source

Zadejte cestu k místnímu zdrojovému souboru, která se nahraje do souboru Datalake Gen2.

Vlastnosti parametru

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

Sady parametrů

File

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

-Umask

Při vytváření nové položky a nadřazeného adresáře nemá výchozí seznam ACL, umask omezuje oprávnění k vytvoření souboru nebo adresáře. Výsledné oprávnění udělí p & ^u, kde p je oprávnění a vy jste umask. Podporuje se symbolický symbol (rwxrw-rw-).

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

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

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

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