New-AzDataLakeGen2Item

Reference

Modul:: Az.Storage

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

Syntaxe

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>]

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í

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-ConcurrentTaskCount

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

Typ:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:	SwitchParameter
Aliasy:	cf
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Context

Kontextový objekt služby Azure Storage

Typ:	IStorageContext
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-DefaultProfile

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

Typ:	IAzureContextContainer
Aliasy:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Directory

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-FileSystem

Název systému souborů

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Force

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

Typ:	SwitchParameter
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Metadata

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

Typ:	Hashtable
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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 directory/file.txt nebo directory1/directory2/.

Typ:	String
Position:	1
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	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.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	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.

Typ:	Hashtable
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Source

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

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	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-).

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:	SwitchParameter
Aliasy:	wi
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

String

IStorageContext

Výstupy

AzureDataLakeGen2Item

Sdílet prostřednictvím