Close-AzStorageFileHandle
關閉檔案共享、檔案目錄或檔案的檔案句柄。
Syntax
Close-AzStorageFileHandle
[-ShareName] <String>
[[-Path] <String>]
[-Recursive]
[-CloseAll]
[-Context <IStorageContext>]
[-DisAllowTrailingDot]
[-PassThru]
[-AsJob]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Close-AzStorageFileHandle
[-ShareName] <String>
-FileHandle <PSFileHandle>
[-Context <IStorageContext>]
[-DisAllowTrailingDot]
[-PassThru]
[-AsJob]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Close-AzStorageFileHandle
[-Share] <CloudFileShare>
[-ShareClient <ShareClient>]
[[-Path] <String>]
[-Recursive]
[-CloseAll]
[-PassThru]
[-AsJob]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Close-AzStorageFileHandle
[-Share] <CloudFileShare>
[-ShareClient <ShareClient>]
-FileHandle <PSFileHandle>
[-PassThru]
[-AsJob]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Close-AzStorageFileHandle
[-Directory] <CloudFileDirectory>
[-ShareDirectoryClient <ShareDirectoryClient>]
[[-Path] <String>]
[-Recursive]
[-CloseAll]
[-PassThru]
[-AsJob]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Close-AzStorageFileHandle
[-File] <CloudFile>
[-ShareFileClient <ShareFileClient>]
[-CloseAll]
[-PassThru]
[-AsJob]
[-ServerTimeoutPerRequest <Int32>]
[-ClientTimeoutPerRequest <Int32>]
[-DefaultProfile <IAzureContextContainer>]
[-ConcurrentTaskCount <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Close-Az 儲存體 FileHandle Cmdlet 會關閉檔案共享或檔案目錄或檔案的檔案句柄。
範例
範例 1:關閉檔案上的所有檔句柄
Close-AzStorageFileHandle -ShareName "mysharename" -Path 'dir1/dir2/test.txt' -CloseAll
此命令會關閉檔案上的所有檔案句柄。
範例 2:關閉檔案目錄中 1 天前開啟的所有檔句柄
Get-AzStorageFileHandle -ShareName "mysharename" -Path 'dir1/dir2' -Recursive | Where-Object {$_.OpenTime.DateTime.AddDays(1) -lt (Get-Date)} | Close-AzStorageFileHandle -ShareName "mysharename"
此命令會以遞歸方式列出檔案目錄上的所有檔句柄,篩選出 1 天前開啟的句柄,然後關閉這些句柄。
範例 3:以遞歸方式關閉檔案目錄上的所有檔句柄,並顯示已關閉的檔案句柄計數
Close-AzStorageFileHandle -ShareName "mysharename" -Path 'dir1/dir2' -Recursive -CloseAll -PassThru
10
此命令會關閉檔案目錄上的所有檔句柄,並顯示已關閉的檔案句柄計數。
範例 4:關閉檔案共用上的所有檔案句柄
Close-AzStorageFileHandle -ShareName "mysharename" -CloseAll -Recursive
此命令會以遞歸方式關閉特定檔案共用上的所有檔句柄。
參數
-AsJob
在背景執行 Cmdlet
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClientTimeoutPerRequest
用戶端每個要求的運行時間上限,以秒為單位。
Type: | Nullable<T>[Int32] |
Aliases: | ClientTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CloseAll
強制關閉所有檔案句柄。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConcurrentTaskCount
並行異步工作的總數量。 預設值為 10。
Type: | Nullable<T>[Int32] |
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 |
-Directory
CloudFileDirectory 物件指出要列出檔案/目錄的基底資料夾。
Type: | CloudFileDirectory |
Aliases: | CloudFileDirectory |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisAllowTrailingDot
不允許尾端點 (.) 後置詞目錄和檔名。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-File
CloudFile 物件指出要關閉句柄的檔案。
Type: | CloudFile |
Aliases: | CloudFile |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-FileHandle
要關閉的檔案句柄。
Type: | PSFileHandle |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
傳回已關閉檔句柄的計數。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
現有檔案/目錄的路徑。
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Recursive
清單會以遞歸方式處理。 僅適用於檔案目錄。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ServerTimeoutPerRequest
伺服器會以秒為單位針對每個要求逾時。
Type: | Nullable<T>[Int32] |
Aliases: | ServerTimeoutPerRequestInSeconds |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Share
CloudFileShare 物件指出將列出檔案/目錄的共用。
Type: | CloudFileShare |
Aliases: | CloudFileShare |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareClient
ShareClient 物件指出共用,其中包含要關閉句柄的檔案/目錄。
Type: | ShareClient |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareDirectoryClient
ShareDirectoryClient 物件指出基底資料夾,其中包含要關閉句柄的檔案/目錄。
Type: | ShareDirectoryClient |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ShareFileClient
ShareFileClient 物件指出要關閉句柄的檔案。
Type: | ShareFileClient |
Position: | Named |
Default value: | None |
Required: | False |
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 |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸入
輸出
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應