New-AzDataLakeGen2Item

Referencia

Módulo:: Az.Storage

Cree un archivo o directorio en un sistema de archivos.

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

Description

El cmdlet New-AzDataLakeGen2Item crea un archivo o directorio en un sistema de archivos de una cuenta de almacenamiento de Azure. Este cmdlet solo funciona si el espacio de nombres jerárquico está habilitado para la cuenta de almacenamiento. Este tipo de cuenta se puede crear mediante la ejecución del cmdlet "New-AzStorageAccount" con "-EnableHierarchicalNamespace $true".

Ejemplos

Ejemplo 1: Creación de un directorio con el permiso especificado, Umask, propiedades y metadatos

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

Este comando crea un directorio con el permiso, Umask, las propiedades y los metadatos especificados.

Ejemplo 2: Crear(cargar) un archivo de lago de datos desde un archivo de origen local y el cmdlet se ejecuta en segundo plano

$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

Este comando crea(carga) un archivo de lago de datos a partir de un archivo de origen local y el cmdlet se ejecuta en segundo plano.

Ejemplo 3: Crear(cargar) un archivo de lago de datos desde un archivo de origen local y establecer su contexto de cifrado

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

encryptioncontext

Este comando crea(carga) un archivo de lago de datos desde un archivo de origen local y establece su valor de contexto de cifrado en "encryptioncontext".

Parámetros

-AsJob

Ejecución del cmdlet en segundo plano

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConcurrentTaskCount

Cantidad total de tareas asincrónicas simultáneas. El valor predeterminado es 10.

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Context

Objeto de contexto de Azure Storage

Type:	IStorageContext
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Directory

Indica que este nuevo elemento es un directorio y no un archivo.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionContext

Contexto de cifrado del archivo. El contexto de cifrado es metadatos que no se cifran cuando se almacenan en el archivo. La aplicación principal de este campo es almacenar datos no cifrados que se pueden usar para derivar la clave proporcionada por el cliente para un archivo. No es aplicable a los directorios.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FileSystem

Nombre del sistema de archivos

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Force

Si se pasa, se crea un nuevo elemento sin ningún mensaje

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Metadata

Especifica los metadatos del directorio o archivo creados.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

Ruta de acceso del sistema de archivos especificado que se debe crear. Puede ser un archivo o directorio con el formato "directory/file.txt" o "directory1/directory2/"

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Permission

Establece los permisos de acceso POSIX para el propietario del archivo, el grupo propietario del archivo y otros. A cada clase se le puede conceder permiso de lectura, escritura o ejecución. Se admite simbólico (rwxrw-rw-). El bit pegajoso también se admite y su representado por la letra t o T en el carácter final en función de si el bit de ejecución de la categoría de otros se establece o no se establece respectivamente, la ausencia de t o T indica que el bit pegajoso no está establecido.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Property

Especifica las propiedades del directorio o archivo creados. Las propiedades admitidas para el archivo son: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType. Las propiedades admitidas para el directorio son: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Source

Especifique la ruta de acceso del archivo de origen local que se cargará en un archivo Datalake Gen2.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Umask

Al crear nuevo elemento y el directorio primario no tiene una ACL predeterminada, el umask restringe los permisos del archivo o directorio que se va a crear. El permiso resultante lo concede p & ^u, donde p es el permiso y usted es el umask. Se admite simbólico (rwxrw-rw-).

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

String

IStorageContext

Salidas

AzureDataLakeGen2Item