Dela via


Rename-AzStorageFile

Byter namn på en fil.

Syntax

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

Cmdleten Rename-AzStorageFile byter namn på en katalog från en filresurs.

Exempel

Exempel 1: Byt namn på en fil från en filresurs

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

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

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

Det här kommandot byter namn på en fil från testfile1 till testfile2 under filresursen myshare.

Exempel 2: Byt namn på en fil från en filresurs med pipeline

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

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

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

Det här kommandot hämtar ett filklientobjekt först och byter namn på filen från testfile1 till testfile2 med pipeline.

Parametrar

-AsJob

Kör cmdlet i bakgrunden

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ContentType

Anger MIME-innehållstypen för filen. Standardtypen är "application/octet-stream".

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Context

Azure Storage-kontextobjekt

Typ:IStorageContext
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DestinationPath

Målsökvägen att byta namn på filen till.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisAllowDestTrailingDot

Tillåt inte avslutande punkt (.) till suffixets målkatalog och målfilnamn.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisAllowSourceTrailingDot

Tillåt inte avslutande punkt (.) till suffixets källkatalog och källfilnamn.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Tvinga att skriva över den befintliga filen.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IgnoreReadonly

Valfritt. Anger om attributet ReadOnly i en befintlig målfil ska respekteras. Om det är sant lyckas namnbytet, annars misslyckas en tidigare fil på målet med readOnly-attributuppsättningen.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Permission

Om det anges ska behörigheten (säkerhetsbeskrivningen) anges för katalogen/filen. Standardvärde: Ärv. Om SDDL anges som indata måste det ha ägare, grupp och dacl.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ShareClient

ShareClient angav resursen där filen skulle visas.

Typ:ShareClient
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ShareDirectoryClient

ShareDirectoryClient angav resursen där filen skulle visas.

Typ:ShareDirectoryClient
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ShareFileClient

Källfilinstans

Typ:ShareFileClient
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ShareName

Namnet på filresursen där filen skulle visas.

Typ:String
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SourcePath

Sökväg till en befintlig fil.

Typ:String
Position:1
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

ShareFileClient

ShareClient

ShareDirectoryClient

IStorageContext

Utdata

AzureStorageFile