Rename-AzStorageDirectory

參考

模組:: Az.Storage

重新命名目錄。

Syntax

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

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

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

Description

Rename-Az 儲存體 Directory Cmdlet 會從檔案共用重新命名目錄。

範例

範例 1：重新命名目錄

Rename-AzStorageDirectory -ShareName myshare -SourcePath testdir1 -DestinationPath testdir2

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

Type                Length Name
----                ------ ----
Directory                1 testdir2

此命令會將目錄從testdir1重新命名為testdir2。

範例 2：使用管線重新命名目錄

Get-AzStorageFile -ShareName myshare -Path testdir1 | Rename-AzStorageDirectory -DestinationPath testdir2

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

Type                Length Name
----                ------ ----
Directory                1 testdir2

此命令會先從檔案共用取得目錄，然後使用管線將testdir1的目錄重新命名為testdir2。

參數

-AsJob

在背景執行 Cmdlet

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

執行 Cmdlet 之前先提示您確認。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Context

Azure 儲存體 Context 物件

Type:	IStorageContext
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DestinationPath

要重新命名目錄的目標路徑。

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisAllowDestTrailingDot

不允許尾端點（.）後綴目的地目錄和目的地檔名。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisAllowSourceTrailingDot

不允許尾端點（.）後綴來源目錄和來源檔名。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

強制覆寫現有的檔案。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-IgnoreReadonly

選擇性。指定是否應該遵守預先存在的目的地檔案上的 ReadOnly 屬性。如果為 true，則重新命名將會成功，否則目的地上已設定 ReadOnly 屬性的上一個檔案會導致重新命名失敗。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Permission

如果指定許可權（安全性描述元）應針對目錄/檔案設定。默認值：繼承。如果 SDDL 指定為輸入，它必須有擁有者、群組和 dacl。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ShareClient

ShareClienr 指出將列出目錄的共用。

Type:	ShareClient
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ShareDirectoryClient

來源目錄實例

Type:	ShareDirectoryClient
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ShareName

將列出目錄的檔案共享名稱。

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-SourcePath

現有目錄的路徑。

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。未執行 Cmdlet。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

ShareClient

ShareDirectoryClient

IStorageContext

輸出

AzureStorageFileDirectory