New-AzDataLakeGen2Item

Référence

Module:: Az.Storage

Créez un fichier ou un répertoire dans un système de fichiers.

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

L’applet de commande New-AzDataLakeGen2Item crée un fichier ou un répertoire dans un système de fichiers dans un compte de stockage Azure. Cette applet de commande fonctionne uniquement si le Namespace hiérarchique est activé pour le compte de stockage. Ce type de compte peut être créé en exécutant l’applet de commande « New-AzStorageAccount » avec « -EnableHierarchicalNamespace $true ».

Exemples

Exemple 1 : Créer un répertoire avec l’autorisation spécifiée, Umask, propriétés et métadonnées

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

Cette commande crée un répertoire avec l’autorisation, Umask, les propriétés et les métadonnées spécifiées

Exemple 2 : Créer(charger) un fichier data lake à partir d’un fichier source local et l’applet de commande s’exécute en arrière-plan

$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

Cette commande crée(charge) un fichier data lake à partir d’un fichier source local et l’applet de commande s’exécute en arrière-plan.

Exemple 3 : Créer(charger) un fichier data lake à partir d’un fichier source local et définir son contexte de chiffrement

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

encryptioncontext

Cette commande crée(charge) un fichier data lake à partir d’un fichier source local et définit sa valeur de contexte de chiffrement sur « encryptioncontext ».

Paramètres

-AsJob

Exécuter l’applet de commande en arrière-plan

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ConcurrentTaskCount

Quantité totale de tâches asynchrones simultanées. La valeur par défaut est 10.

Type:	Nullable<T>[Int32]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:	SwitchParameter
Alias:	cf
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Context

objet de contexte Stockage Azure

Type:	IStorageContext
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:	IAzureContextContainer
Alias:	AzureRmContext, AzureCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Directory

Indique que ce nouvel élément est un répertoire et non un fichier.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-EncryptionContext

Contexte de chiffrement du fichier. Le contexte de chiffrement est des métadonnées qui ne sont pas chiffrées lorsqu’elles sont stockées sur le fichier. L’application principale de ce champ consiste à stocker des données non chiffrées qui peuvent être utilisées pour dériver la clé fournie par le client pour un fichier. Non applicable aux répertoires.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-FileSystem

Nom du système de fichiers

Type:	String
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Force

S’il est passé, un nouvel élément est créé sans invite

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Metadata

Spécifie les métadonnées pour le répertoire ou le fichier créé.

Type:	Hashtable
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Path

Chemin d’accès dans le système de fichiers spécifié qui doit être créé. Il peut s’agir d’un fichier ou d’un répertoire au format « directory/file.txt » ou « directory1/directory2/ »

Type:	String
Position:	1
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Permission

Définit les autorisations d’accès POSIX pour le propriétaire du fichier, le groupe propriétaire de fichiers et d’autres utilisateurs. Chaque classe peut recevoir une autorisation de lecture, d’écriture ou d’exécution. Symbolique (rwxrw-rw-) est pris en charge. Le bit collant est également pris en charge et est représenté par la lettre t ou T dans le caractère final, selon que le bit d’exécution pour les autres catégories est défini ou non défini respectivement, l’absence de t ou T indique que le bit collant n’est pas défini.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Property

Spécifie les propriétés du répertoire ou du fichier créé. Les propriétés prises en charge pour le fichier sont : CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType. Les propriétés prises en charge pour le répertoire sont : CacheControl, ContentDisposition, ContentEncoding, ContentLanguage.

Type:	Hashtable
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Source

Spécifiez le chemin du fichier source local qui sera chargé dans un fichier Datalake Gen2.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Umask

Lors de la création d’un nouvel élément et du répertoire parent n’ont pas de liste de contrôle d’accès par défaut, l’umask limite les autorisations du fichier ou du répertoire à créer. L’autorisation résultante est donnée par p &^u, où p est l’autorisation et vous êtes l’umask. Symbolique (rwxrw-rw-) est pris en charge.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:	SwitchParameter
Alias:	wi
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

String

IStorageContext

Sorties

AzureDataLakeGen2Item

Partager via