Update-AzDataLakeGen2Item

Módulo:: Az.Storage Module

Atualize um arquivo ou diretório em propriedades, metadados, permissão, ACL e proprietário.

Sintaxe

ReceiveManual (Padrão)

Update-AzDataLakeGen2Item
    [-FileSystem] <String>
    [-Path <String>]
    [-Permission <String>]
    [-Owner <String>]
    [-Group <String>]
    [-Property <Hashtable>]
    [-Metadata <Hashtable>]
    [-Acl <PSPathAccessControlEntry[]>]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ItemPipeline

Update-AzDataLakeGen2Item
    -InputObject <AzureDataLakeGen2Item>
    [-Permission <String>]
    [-Owner <String>]
    [-Group <String>]
    [-Property <Hashtable>]
    [-Metadata <Hashtable>]
    [-Acl <PSPathAccessControlEntry[]>]
    [-Context <IStorageContext>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Update-AzDataLakeGen2Item atualiza um arquivo ou diretório em propriedades, metadados, permissão, ACL e proprietário. 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 objeto ACL com 3 entradas ACL e atualizar ACL para todos os itens em um sistema de arquivos recursivamente

$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType user -Permission rwx
$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType group -Permission rw- -InputObject $acl
$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType other -Permission "rwt" -InputObject $acl
Get-AzDataLakeGen2ChildItem -FileSystem "filesystem1" -Recurse | Update-AzDataLakeGen2Item -ACL $acl

FileSystem Name: filesystem1

Path                 IsDirectory  Length          LastModified         Permissions  Owner                Group
----                 -----------  ------          ------------         -----------  -----                -----
dir1                 True                         2020-03-13 13:07:34Z rwxrw-rwt    $superuser           $superuser
dir1/file1           False        1024            2020-03-23 09:29:18Z rwxrw-rwt    $superuser           $superuser
dir2                 True                         2020-03-23 09:28:36Z rwxrw-rwt    $superuser           $superuser

Esse comando primeiro cria um objeto ACL com 3 entradas acl (use -InputObject parâmetro para adicionar entrada acl ao objeto acl existente) e, em seguida, obtenha todos os itens em um sistema de arquivos e atualize a acl nos itens.

Exemplo 2: atualizar todas as propriedades em um arquivo e mostrá-las

$file = Update-AzDataLakeGen2Item -FileSystem "filesystem1" -Path "dir1/file1" `
                 -Acl $acl `
                 -Property @{"ContentType" = "image/jpeg"; "ContentMD5" = "i727sP7HigloQDsqadNLHw=="; "ContentEncoding" = "UDF8"; "CacheControl" = "READ"; "ContentDisposition" = "True"; "ContentLanguage" = "EN-US"} `
                 -Metadata  @{"tag1" = "value1"; "tag2" = "value2" } `
                 -Permission rw-rw-rwx `
                 -Owner '$superuser' `
                 -Group '$superuser'

$file

   FileSystem Name: filesystem1

Path                 IsDirectory  Length          LastModified         Permissions  Owner                Group
----                 -----------  ------          ------------         -----------  -----                -----
dir1/file1           False        1024            2020-03-23 09:57:33Z rwxrw-rw-    $superuser           $superuser

$file.ACL

DefaultScope AccessControlType EntityId Permissions
------------ ----------------- -------- -----------
False        User                       rwx
False        Group                      rw-
False        Other                      rw-

$file.Permissions

Owner        : Execute, Write, Read
Group        : Write, Read
Other        : Write, Read
StickyBit    : False
ExtendedAcls : False

$file.Properties.Metadata

Key  Value
---  -----
tag2 value2
tag1 value1

$file.Properties


LastModified          : 3/23/2020 9:57:33 AM +00:00
CreatedOn             : 3/23/2020 9:29:18 AM +00:00
Metadata              : {[tag2, value2], [tag1, value1]}
CopyCompletedOn       : 1/1/0001 12:00:00 AM +00:00
CopyStatusDescription :
CopyId                :
CopyProgress          :
CopySource            :
CopyStatus            : Pending
IsIncrementalCopy     : False
LeaseDuration         : Infinite
LeaseState            : Available
LeaseStatus           : Unlocked
ContentLength         : 1024
ContentType           : image/jpeg
ETag                  : "0x8D7CF109B9878CC"
ContentHash           : {139, 189, 187, 176...}
ContentEncoding       : UDF8
ContentDisposition    : True
ContentLanguage       : EN-US
CacheControl          : READ
AcceptRanges          : bytes
IsServerEncrypted     : True
EncryptionKeySha256   :
AccessTier            : Cool
ArchiveStatus         :
AccessTierChangedOn   : 1/1/0001 12:00:00 AM +00:00

Esse comando atualiza todas as propriedades em um arquivo (ACL, permissão, proprietário, grupo, metadados, propriedade pode ser atualizada com qualquer combinação) e mostra-as no console do Powershell.

Exemplo 3: Adicionar uma entrada ACL a um diretório

## Get the origin ACL
$acl = (Get-AzDataLakeGen2Item -FileSystem "filesystem1" -Path 'dir1/dir3/').ACL

# Update permission of a new ACL entry (if ACL entry with same AccessControlType/EntityId/DefaultScope not exist, will add a new ACL entry, else update permission of existing ACL entry)
$acl = Set-AzDataLakeGen2ItemAclObject -AccessControlType user -EntityId $id -Permission rw- -InputObject $acl

# set the new acl to the directory
Update-AzDataLakeGen2Item -FileSystem "filesystem1" -Path 'dir1/dir3/' -ACL $acl

FileSystem Name: filesystem1

Path                 IsDirectory  Length          LastModified         Permissions  Owner                Group
----                 -----------  ------          ------------         -----------  -----                -----
dir1/dir3            True                         2020-03-23 09:34:31Z rwxrw-rw-+   $superuser           $superuser

Esse comando obtém ACL de um diretório, atualiza/adiciona uma entrada ACL e define de volta para o diretório. Se a entrada ACL com o mesmo AccessControlType/EntityId/DefaultScope não existir, adicionará uma nova entrada ACL, caso contrário, a permissão de atualização da entrada ACL existente.

Parâmetros

-Acl

Define os direitos de controle de acesso POSIX em arquivos e diretórios. Crie este objeto com New-AzDataLakeGen2ItemAclObject.

Propriedades do parâmetro

Tipo:	PSPathAccessControlEntry[]
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Confirm

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	cf

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Context

Objeto de contexto de armazenamento do Azure

Propriedades do parâmetro

Tipo:	IStorageContext
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-DefaultProfile

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

Propriedades do parâmetro

Tipo:	IAzureContextContainer
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-FileSystem

Nome do FileSystem

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ReceiveManual

Cargo:	0
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Group

Define o grupo proprietário do blob.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-InputObject

Objeto de item do Azure Datalake Gen2 a ser atualizado

Propriedades do parâmetro

Tipo:	AzureDataLakeGen2Item
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ItemPipeline

Cargo:	Named
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Metadata

Especifica metadados para o diretório ou arquivo.

Propriedades do parâmetro

Tipo:	Hashtable
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Owner

Define o proprietário do blob.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Path

O caminho no sistema de arquivos especificado que deve ser atualizado. Pode ser um arquivo ou diretório no formato 'directory/file.txt' ou 'directory1/directory2/'. Não especifique que esse parâmetro atualizará o diretório raiz do sistema de arquivos.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ReceiveManual

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	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 simbólico (rwxrw-rw-) . O bit autoadesiva também tem suporte e é representado pela letra t ou T no local do caractere final, dependendo se o bit de execução para a categoria de outras pessoas está definido ou não definido, respectivamente, a ausência de t ou T indica que o bit autoadesiva não está definido. Inválido em conjunto com ACL.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Property

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

Propriedades do parâmetro

Tipo:	Hashtable
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-WhatIf

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

Propriedades do parâmetro

Tipo:	SwitchParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	wi

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

AzureDataLakeGen2Item

Comentários

Esta página foi útil?

Compartilhar via

Update-AzDataLakeGen2Item

Sintaxe

ReceiveManual (Padrão)

ItemPipeline

Description

Exemplos

Exemplo 1: criar um objeto ACL com 3 entradas ACL e atualizar ACL para todos os itens em um sistema de arquivos recursivamente

Exemplo 2: atualizar todas as propriedades em um arquivo e mostrá-las

Exemplo 3: Adicionar uma entrada ACL a um diretório

Parâmetros

-Acl

Propriedades do parâmetro

Conjuntos de parâmetros

-Confirm

Propriedades do parâmetro

Conjuntos de parâmetros

-Context

Propriedades do parâmetro

Conjuntos de parâmetros

-DefaultProfile

Propriedades do parâmetro

Conjuntos de parâmetros

-FileSystem

Propriedades do parâmetro

Conjuntos de parâmetros

-Group

Propriedades do parâmetro

Conjuntos de parâmetros

-InputObject

Propriedades do parâmetro

Conjuntos de parâmetros

-Metadata

Propriedades do parâmetro

Conjuntos de parâmetros

-Owner

Propriedades do parâmetro

Conjuntos de parâmetros

-Path

Propriedades do parâmetro

Conjuntos de parâmetros

-Permission

Propriedades do parâmetro

Conjuntos de parâmetros

-Property

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters

Entradas

String

AzureDataLakeGen2Item

IStorageContext

Saídas

AzureDataLakeGen2Item

Comentários