New-AzDataLakeGen2Item

Referenz

Modul:: Az.Storage

Erstellen Sie eine Datei oder ein Verzeichnis in einem Dateisystem.

Syntax

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

Beschreibung

Das Cmdlet New-AzDataLakeGen2Item erstellt eine Datei oder ein Verzeichnis in einem Dateisystem in einem Azure-Speicherkonto. Dieses Cmdlet funktioniert nur, wenn der hierarchische Namespace für das Speicherkonto aktiviert ist. Diese Art von Konto kann mit dem Cmdlet "New-AzStorageAccount" mit "-EnableHierarchicalNamespace $true" erstellt werden.

Beispiele

Beispiel 1: Erstellen eines Verzeichnisses mit angegebenen Berechtigungen, Umask, Eigenschaften und Metadaten

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

Mit diesem Befehl wird ein Verzeichnis mit angegebenen Berechtigungen, Umask, Eigenschaften und Metadaten erstellt.

Beispiel 2: Erstellen(Hochladen) einer Data Lake-Datei aus einer lokalen Quelldatei und das Cmdlet wird im Hintergrund ausgeführt

$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

Mit diesem Befehl wird eine Data Lake-Datei aus einer lokalen Quelldatei erstellt(hochladen), und das Cmdlet wird im Hintergrund ausgeführt.

Beispiel 3: Erstellen(Hochladen) einer Data Lake-Datei aus einer lokalen Quelldatei und Festlegen des Verschlüsselungskontexts

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

encryptioncontext

Mit diesem Befehl wird eine Data Lake-Datei aus einer lokalen Quelldatei erstellt(hochladen) und der Verschlüsselungskontextwert auf "encryptioncontext" festgelegt.

Parameter

-AsJob

Cmdlet im Hintergrund ausführen

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ConcurrentTaskCount

Die Gesamtmenge der gleichzeitigen asynchronen Vorgänge. Der Standardwert lautet 10.

Typ:	Nullable<T>[Int32]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Context

Azure Storage Context-Objekt

Typ:	IStorageContext
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:	IAzureContextContainer
Aliase:	AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Directory

Gibt an, dass es sich bei diesem neuen Element um ein Verzeichnis und nicht um eine Datei handelt.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-EncryptionContext

Verschlüsselungskontext der Datei. Der Verschlüsselungskontext ist Metadaten, die nicht verschlüsselt werden, wenn sie in der Datei gespeichert sind. Die primäre Anwendung dieses Felds besteht darin, nicht verschlüsselte Daten zu speichern, die zum Ableiten des vom Kunden bereitgestellten Schlüssels für eine Datei verwendet werden können. Gilt nicht für Verzeichnisse.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-FileSystem

Dateisystemname

Typ:	String
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Force

Wenn das Element übergeben wird, wird ohne Aufforderung ein neues Element erstellt.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Metadata

Gibt Metadaten für das erstellte Verzeichnis oder die erstellte Datei an.

Typ:	Hashtable
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Path

Der Pfad im angegebenen Dateisystem, das erstellt werden soll. Kann eine Datei oder ein Verzeichnis im Format 'directory/file.txt' oder 'directory1/directory2/' sein.

Typ:	String
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Permission

Legt POSIX-Zugriffsberechtigungen für den Dateibesitzer, die Besitzergruppe der Datei und andere fest. Jeder Klasse kann Lese-, Schreib- oder Ausführungsberechtigungen erteilt werden. Symbolisch (rwxrw-rw-) wird unterstützt. Das klebige Bit wird ebenfalls unterstützt und wird entweder durch den Buchstaben t oder T am endgültigen Zeichenplatz dargestellt, je nachdem, ob das Ausführungsbit für die andere Kategorie festgelegt oder nicht festgelegt ist, das Fehlen von "t" oder "T" nicht festgelegt ist.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Property

Gibt Eigenschaften für das erstellte Verzeichnis oder die erstellte Datei an. Die unterstützten Eigenschaften für die Datei sind: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType. Die unterstützten Eigenschaften für das Verzeichnis sind: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage.

Typ:	Hashtable
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Source

Geben Sie den lokalen Quelldateipfad an, der in eine Datalake Gen2-Datei hochgeladen wird.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Umask

Beim Erstellen eines neuen Elements und des übergeordneten Verzeichnisses ist keine Standard-ACL vorhanden, schränkt der Umask die Berechtigungen der zu erstellenden Datei oder des Verzeichnisses ein. Die resultierende Berechtigung wird von p & ^u erteilt, wobei p die Berechtigung ist und Sie die Umask sind. Symbolisch (rwxrw-rw-) wird unterstützt.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

String

IStorageContext

Ausgaben

AzureDataLakeGen2Item

Freigeben über