Delen via


New-AzDataLakeGen2Item

Maak een bestand of map in een bestandssysteem.

Syntaxis

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

Met de cmdlet New-AzDataLakeGen2Item maakt u een bestand of map in een bestandssysteem in een Azure-opslagaccount. Deze cmdlet werkt alleen als hiërarchische naamruimte is ingeschakeld voor het opslagaccount. Dit type account kan worden gemaakt door de cmdlet New-AzStorageAccount uit te voeren met "-EnableHierarchicalNamespace $true".

Voorbeelden

Voorbeeld 1: Een map maken met de opgegeven machtiging, Umask, eigenschappen en metagegevens

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

Met deze opdracht maakt u een map met de opgegeven machtiging, Umask, eigenschappen en metagegevens

Voorbeeld 2: Een Data Lake-bestand maken (uploaden) vanuit een lokaal bronbestand en de cmdlet wordt op de achtergrond uitgevoerd

$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

Met deze opdracht maakt(uploadt) u een Data Lake-bestand vanuit een lokaal bronbestand en wordt de cmdlet op de achtergrond uitgevoerd.

Voorbeeld 3: Een Data Lake-bestand maken (uploaden) vanuit een lokaal bronbestand en de versleutelingscontext instellen

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

encryptioncontext

Met deze opdracht maakt(uploadt) u een Data Lake-bestand van een lokaal bronbestand en stelt u de versleutelingscontextwaarde in op 'encryptioncontext'.

Parameters

-AsJob

Cmdlet op de achtergrond uitvoeren

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ConcurrentTaskCount

De totale hoeveelheid gelijktijdige asynchrone taken. De standaardwaarde is 10.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Context

Azure Storage-contextobject

Type:IStorageContext
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Directory

Geeft aan dat dit nieuwe item een map is en geen bestand.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EncryptionContext

Versleutelingscontext van het bestand. Versleutelingscontext is metagegevens die niet zijn versleuteld wanneer ze zijn opgeslagen in het bestand. De primaire toepassing van dit veld is het opslaan van niet-versleutelde gegevens die kunnen worden gebruikt om de door de klant geleverde sleutel voor een bestand af te leiden. Niet van toepassing op directory's.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FileSystem

Bestandsnaam

Type:String
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Force

Als dit wordt doorgegeven, wordt er zonder prompt een nieuw item gemaakt

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Metadata

Hiermee geeft u metagegevens voor de gemaakte map of het bestand.

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Path

Het pad in het opgegeven bestandssysteem dat moet worden gemaakt. Kan een bestand of map zijn in de indeling 'directory/file.txt' of 'directory1/directory2/'

Type:String
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Permission

Hiermee stelt u POSIX-toegangsmachtigingen in voor de bestandseigenaar, de groep die eigenaar is van het bestand en andere. Aan elke klasse kan een machtiging voor lezen, schrijven of uitvoeren worden verleend. Symbolisch (rwxrw-rw-) wordt ondersteund. De plak-bit wordt ook ondersteund en wordt vertegenwoordigd door de letter t of T op de uiteindelijke tekenplaats, afhankelijk van of de uitvoeringsbit voor de andere categorie is ingesteld of uitgezet, afwezigheid van t of T geeft aan dat plakbit niet is ingesteld.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Property

Hiermee geeft u eigenschappen voor de gemaakte map of het bestand. De ondersteunde eigenschappen voor het bestand zijn: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType. De ondersteunde eigenschappen voor map zijn: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage.

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Source

Geef het lokale bronbestandspad op dat naar een Datalake Gen2-bestand wordt geüpload.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Umask

Wanneer u Nieuw item maakt en de bovenliggende map geen standaard-ACL heeft, beperkt de umask de machtigingen van het bestand of de map die moet worden gemaakt. De resulterende machtiging wordt gegeven door p & ^u, waarbij p de machtiging is en u de umask. Symbolisch (rwxrw-rw-) wordt ondersteund.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

String

IStorageContext

Uitvoerwaarden

AzureDataLakeGen2Item