Rename-AzStorageFile

Referência

Módulo:: Az.Storage

Renomeia um arquivo.

Sintaxe

Rename-AzStorageFile
      [-ShareName] <String>
      [-SourcePath] <String>
      [[-DestinationPath] <String>]
      [-ContentType <String>]
      [-Permission <String>]
      [-DisAllowSourceTrailingDot]
      [-DisAllowDestTrailingDot]
      [-Force]
      [-AsJob]
      [-Context <IStorageContext>]
      [-DefaultProfile <IAzureContextContainer>]
      [-IgnoreReadonly]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Rename-AzStorageFile
      [-ShareFileClient] <ShareFileClient>
      [[-DestinationPath] <String>]
      [-ContentType <String>]
      [-Permission <String>]
      [-Force]
      [-AsJob]
      [-Context <IStorageContext>]
      [-DefaultProfile <IAzureContextContainer>]
      [-IgnoreReadonly]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Rename-AzStorageFile
      [-ShareClient] <ShareClient>
      [-SourcePath] <String>
      [[-DestinationPath] <String>]
      [-ContentType <String>]
      [-Permission <String>]
      [-Force]
      [-AsJob]
      [-Context <IStorageContext>]
      [-DefaultProfile <IAzureContextContainer>]
      [-IgnoreReadonly]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Rename-AzStorageFile
      [-ShareDirectoryClient] <ShareDirectoryClient>
      [-SourcePath] <String>
      [[-DestinationPath] <String>]
      [-ContentType <String>]
      [-Permission <String>]
      [-Force]
      [-AsJob]
      [-Context <IStorageContext>]
      [-DefaultProfile <IAzureContextContainer>]
      [-IgnoreReadonly]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Rename-AzStorageFile renomeia um diretório de um compartilhamento de arquivos.

Exemplos

Exemplo 1: renomear um arquivo de um compartilhamento de arquivo

Rename-AzStorageFile -SourcePath testfile1 -DestinationPath testfile2 -ShareName myshare

AccountName: myaccount, ShareName: myshare

Type                Length Name
----                ------ ----
File                   512 testfile2

Esse comando renomeia um arquivo de testfile1 para testfile2 em myshare de compartilhamento de arquivo.

Exemplo 2: renomear um arquivo de um compartilhamento de arquivos usando pipeline

Get-AzStorageFile -ShareName myshare -Path testfile1 | Rename-AzStorageFile -DestinationPath testfile2

AccountName: myaccount, ShareName: myshare

Type                Length Name
----                ------ ----
File                   512 testfile2

Esse comando obtém primeiro um objeto cliente de arquivo e renomeia o arquivo de testfile1 para testfile2 usando pipeline.

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

-Confirm

Solicita a 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

-ContentType

Define o tipo de conteúdo MIME do arquivo. O tipo padrão é "application/octet-stream".

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

-Context

Objeto de contexto de 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 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

-DestinationPath

O caminho de destino para o qual renomear o arquivo.

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

-DisAllowDestTrailingDot

Não permitir o ponto à direita (.) para sufixo de diretório de destino e nomes de arquivo de destino.

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

-DisAllowSourceTrailingDot

Não permitir o ponto à direita (.) para sufixo de diretório de origem e nomes de arquivo de origem.

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

-Force

Force a substituir o arquivo existente.

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

-IgnoreReadonly

Opcional. Especifica se o atributo ReadOnly em um arquivo de destino pré-inicial deve ser respeitado. Se for true, a renomeação terá êxito, caso contrário, um arquivo anterior no destino com o conjunto de atributos ReadOnly fará com que a renomeação falhe.

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

-Permission

Se especificado, a permissão (descritor de segurança) será definida para o diretório/arquivo. Valor padrão: Herdar. Se o SDDL for especificado como entrada, ele deverá ter proprietário, grupo e dacl.

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

-ShareClient

ShareClient indicou o compartilhamento em que o arquivo seria listado.

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

-ShareDirectoryClient

ShareDirectoryClient indicou o compartilhamento em que o arquivo seria listado.

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

-ShareFileClient

Instância do arquivo de origem

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

-ShareName

Nome do compartilhamento de arquivos em que o arquivo seria listado.

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

-SourcePath

Caminho para um arquivo existente.

Tipo:	String
Cargo:	1
Valor padrão:	None
Obrigatório:	True
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

ShareFileClient

ShareClient

ShareDirectoryClient

IStorageContext

Saídas

AzureStorageFile

Compartilhar via