Move-AzDataLakeGen2Item
將檔案或目錄移至相同儲存體帳戶中的另一個檔案或目錄。
語法
ReceiveManual (預設值)
Move-AzDataLakeGen2Item
[-FileSystem] <String>
[-Path] <String>
-DestFileSystem <String>
-DestPath <String>
[-Force]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ItemPipeline
Move-AzDataLakeGen2Item
-InputObject <AzureDataLakeGen2Item>
-DestFileSystem <String>
-DestPath <String>
[-Force]
[-Context <IStorageContext>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Move-AzDataLakeGen2Item Cmdlet 會將檔案或目錄移至相同儲存體帳戶中的另一個檔案或目錄。
只有在儲存體帳戶啟用階層式命名空間時，此 Cmdlet 才有效。 您可以透過執行 “New-AzStorageAccount” Cmdlet 搭配 “-EnableHierarchicalNamespace $true” 來建立這種帳戶。
範例
範例 1：在相同的檔案系統中移動摺疊
Move-AzDataLakeGen2Item -FileSystem "filesystem1" -Path "dir1/" -DestFileSystem "filesystem1" -DestPath "dir3/"
FileSystem Name: filesystem1
Path IsDirectory Length LastModified Permissions Owner Group
---- ----------- ------ ------------ ----------- ----- -----
dir3 True 2020-03-13 13:07:34Z rwxrw-rw- $superuser $superuser
此命令將目錄 'dir1' 移動到同一檔案系統中的目錄 'dir3'。
範例 2：依管線將檔案移至相同儲存體帳戶中的另一個檔案系統，而不需要提示
Get-AzDataLakeGen2Item -FileSystem "filesystem1" -Path "dir1/file1" | Move-AzDataLakeGen2Item -DestFileSystem "filesystem2" -DestPath "dir2/file2" -Force
FileSystem Name: filesystem2
Path IsDirectory Length LastModified Permissions Owner Group
---- ----------- ------ ------------ ----------- ----- -----
dir2/file2 False 1024 2020-03-23 09:57:33Z rwxrw-rw- $superuser $superuser
此命令會將 'filesystem1' 中的檔案 'dir1/file1' 移至相同儲存體帳戶中 'filesystem2' 中的檔案 'dir2/file2'，而不會出現提示。
範例 3：使用 Sas 權杖移動項目
$sas = New-AzStorageContainerSASToken -Name $filesystemName -Permission rdw -Context $ctx
$sasctx = New-AzStorageContext -StorageAccountName $ctx.StorageAccountName -SasToken $sas
Move-AzDataLakeGen2Item -FileSystem $filesystemName -Path $itempath1 -DestFileSystem $filesystemName -DestPath "$($itempath2)$($sas)" -Context $sasctx
FileSystem Name: filesystem1
Path IsDirectory Length LastModified Permissions Owner Group
---- ----------- ------ ------------ ----------- ----- -----
dir2/file1 False 1024 2021-03-23 09:57:33Z rwxrw-rw- $superuser $superuser
第一個命令會建立具有 rdw 許可權的 Sas 權杖，第二個命令會從 Sas 權杖建立儲存體內容，第三個命令會使用 Sas 權杖移動專案。
此範例在來源和目的地上使用具有 rdw 權限的相同 Sastoken，如果對來源和目的地使用 2 個 SAS 權杖，則來源需要權限 rd，目的地需要權限 w。
參數
-Confirm
在執行 Cmdlet 之前，提示您進行確認。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Context
Azure 儲存體內容物件
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-DefaultProfile
用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DestFileSystem
目的地檔案系統名稱
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DestPath
目的地 Blob 路徑
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-FileSystem
檔案系統名稱
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ReceiveManual
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Force
強制覆蓋目的地。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
要從中移動的 Azure Datalake Gen2 專案物件。
ItemPipeline
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Path
指定檔案系統中應從中移動的路徑。
可以是檔案或目錄，格式為 'directory/file.txt' 或 'directory1/directory2/'
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ReceiveManual
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。
指令未執行。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸出
