New-AzDataLakeGen2Item

Referencia

Módulo:: Az.Storage

Cree un archivo o directorio en un sistema de archivos.

Sintaxis

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ConcurrentTaskCount

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

Tipo:	Nullable<T>[Int32]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Context

Objeto de contexto de Azure Storage

Tipo:	IStorageContext
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:	IAzureContextContainer
Alias:	AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Directory

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-FileSystem

Nombre del sistema de archivos

Tipo:	String
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Force

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Metadata

Especifica los metadatos del directorio o archivo creados.

Tipo:	Hashtable
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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/"

Tipo:	String
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	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.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Hashtable
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Source

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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	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. P & ^u, donde p es el permiso y usted es el umask. Se admite simbólico (rwxrw-rw-).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

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

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

String

IStorageContext

Salidas

AzureDataLakeGen2Item

Compartir a través de