Compartilhar via

New-AzDataLakeGen2Item

  • Referência
Módulo:
Az.Storage

Crie um arquivo ou diretório em um sistema de arquivos.

Sintaxe

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

O cmdlet New-AzDataLakeGen2Item cria um arquivo ou diretório em um sistema de arquivos em uma conta de armazenamento do Azure. Esse cmdlet só funcionará se o Namespace Hierárquico estiver habilitado para a conta de armazenamento. Esse tipo de conta pode ser criado executando o cmdlet "New-AzStorageAccount" com "-EnableHierarchicalNamespace $true".

Exemplos

Exemplo 1: Criar um diretório com permissão especificada, Umask, propriedades e metadados

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 cria um diretório com Permissão, Umask, propriedades e metadados especificados

Exemplo 2: Criar(carregar) um arquivo de data lake de um arquivo de origem local e o cmdlet é executado em 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

Esse comando cria (carregar) um arquivo de data lake de um arquivo de origem local e o cmdlet é executado em segundo plano.

Exemplo 3: criar (carregar) um arquivo de data lake de um arquivo de origem local e definir seu contexto de criptografia

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

encryptioncontext

Esse comando cria (carrega) um arquivo de data lake de um arquivo de origem local e define seu valor de contexto de criptografia como "encryptioncontext".

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ConcurrentTaskCount

A quantidade total de tarefas assíncronas simultâneas. O valor padrão é 10.

Tipo:Nullable<T>[Int32]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Context

Objeto de contexto do Armazenamento do Azure

Tipo:IStorageContext
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Directory

Indica que esse novo item é um diretório e não um arquivo.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EncryptionContext

Contexto de criptografia do arquivo. O contexto de criptografia são metadados que não são criptografados quando armazenados no arquivo. A principal aplicação desse campo é armazenar dados não criptografados que podem ser usados para derivar a chave fornecida pelo cliente para um arquivo. Não aplicável a diretórios.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FileSystem

Nome do sistema de arquivos

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Force

Se aprovado, um novo item será criado sem qualquer aviso

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Metadata

Especifica metadados para o diretório ou arquivo criado.

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Path

O caminho no sistema de arquivos especificado que deve ser criado. Pode ser um arquivo ou diretório no formato 'diretório/file.txt' ou 'diretório1/diretório2/'

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Permission

Define permissões de acesso POSIX para o proprietário do arquivo, o grupo proprietário do arquivo e outros. Cada classe pode receber permissão de leitura, gravação ou execução. Há suporte para o simbólico (rwxrw-rw-). O sticky bit também é suportado e é representado pela letra t ou T no local do caractere final, dependendo se o bit de execução para a categoria de outros está definido ou não, respectivamente, a ausência de t ou T indica sticky bit não definido.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Property

Especifica as propriedades do diretório ou arquivo criado. As propriedades com suporte para o arquivo são: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage, ContentMD5, ContentType. As propriedades com suporte para o diretório são: CacheControl, ContentDisposition, ContentEncoding, ContentLanguage.

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Source

Especifique o caminho do arquivo de origem local que será carregado em um arquivo do Datalake Gen2.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Umask

Ao criar Novo Item e o diretório pai não tiver uma ACL padrão, o umask restringe as permissões do arquivo ou diretório a ser criado. A permissão resultante é dada por p & ^u, onde p é a permissão e u é o umask. Há suporte para o simbólico (rwxrw-rw-).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

IStorageContext

Saídas

AzureDataLakeGen2Item