Bagikan melalui


Rename-AzStorageFile

Mengganti nama file.

Sintaks

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

Deskripsi

Cmdlet Rename-AzStorageFile mengganti nama direktori dari berbagi file.

Contoh

Contoh 1 : Mengganti nama file dari berbagi file

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

Directory: https://myaccount.file.core.windows.net/myshare

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

Perintah ini mengganti nama file dari testfile1 menjadi testfile2 di bawah berbagi file myshare.

Contoh 2 : Mengganti nama file dari berbagi menggunakan alur

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

Directory: https://myaccount.file.core.windows.net/myshare

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

Perintah ini mendapatkan objek klien file terlebih dahulu, dan mengganti nama file dari testfile1 menjadi testfile2 menggunakan alur.

Parameter

-AsJob

Jalankan cmdlet di latar belakang

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ContentType

Mengatur tipe isi MIME file. Jenis defaultnya adalah 'application/octet-stream'.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Context

Objek Konteks Azure Storage

Jenis:IStorageContext
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Jenis:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DestinationPath

Jalur tujuan untuk mengganti nama file menjadi.

Jenis:String
Position:1
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DisAllowDestTrailingDot

Larang titik berikutnya (.) untuk mencukupkan direktori tujuan dan nama file tujuan.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DisAllowSourceTrailingDot

Larang titik berikutnya (.) untuk mencukupkan direktori sumber dan nama file sumber.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Force

Paksa untuk menimpa file yang ada.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-IgnoreReadonly

Opsional. Menentukan apakah atribut ReadOnly pada file tujuan yang sudah ada sebelumnya harus dihormati. Jika true, penggantian nama akan berhasil, jika tidak, file sebelumnya di tujuan dengan set atribut ReadOnly akan menyebabkan penggantian nama gagal.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Permission

Jika ditentukan, izin (pendeskripsi keamanan) akan diatur untuk direktori/file. Nilai default: Warisi. Jika SDDL ditentukan sebagai input, SDDL harus memiliki pemilik, grup, dan dacl.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ShareClient

ShareClient menunjukkan berbagi tempat file akan dicantumkan.

Jenis:ShareClient
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-ShareDirectoryClient

ShareDirectoryClient menunjukkan berbagi tempat file akan dicantumkan.

Jenis:ShareDirectoryClient
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-ShareFileClient

Instans file sumber

Jenis:ShareFileClient
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-ShareName

Nama berbagi file tempat file akan dicantumkan.

Jenis:String
Position:0
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-SourcePath

Jalur ke file yang sudah ada.

Jenis:String
Position:1
Nilai default:None
Diperlukan:True
Terima input alur:False
Terima karakter wildcard:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

ShareFileClient

ShareClient

ShareDirectoryClient

IStorageContext

Output

AzureStorageFile