Close-AzStorageFileHandle

模組:

Az.Storage

關閉檔案共享、檔案目錄或檔案的檔案句柄。

語法

Close-AzStorageFileHandle
     [-ShareName] <String>
     [[-Path] <String>]
     [-Recursive]
     [-CloseAll]
     [-DisAllowTrailingDot]
     [-PassThru]
     [-AsJob]
     [-Context <IStorageContext>]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Close-AzStorageFileHandle
     [-ShareName] <String>
     -FileHandle <PSFileHandle>
     [-DisAllowTrailingDot]
     [-PassThru]
     [-AsJob]
     [-Context <IStorageContext>]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Close-AzStorageFileHandle
     [-ShareClient] <ShareClient>
     [[-Path] <String>]
     [-Recursive]
     [-CloseAll]
     [-PassThru]
     [-AsJob]
     [-Context <IStorageContext>]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Close-AzStorageFileHandle
     [-ShareClient] <ShareClient>
     -FileHandle <PSFileHandle>
     [-PassThru]
     [-AsJob]
     [-Context <IStorageContext>]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Close-AzStorageFileHandle
     [-ShareDirectoryClient] <ShareDirectoryClient>
     [[-Path] <String>]
     [-Recursive]
     [-CloseAll]
     [-PassThru]
     [-AsJob]
     [-Context <IStorageContext>]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Close-AzStorageFileHandle
     [-ShareFileClient] <ShareFileClient>
     [-CloseAll]
     [-PassThru]
     [-AsJob]
     [-Context <IStorageContext>]
     [-ServerTimeoutPerRequest <Int32>]
     [-ClientTimeoutPerRequest <Int32>]
     [-DefaultProfile <IAzureContextContainer>]
     [-ConcurrentTaskCount <Int32>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Close-AzStorageFileHandle 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

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ClientTimeoutPerRequest

用戶端每個要求的運行時間上限，以秒為單位。

類型:	Nullable<T>[Int32]
別名:	ClientTimeoutPerRequestInSeconds
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-CloseAll

強制關閉所有檔案句柄。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-ConcurrentTaskCount

並行異步工作的總數量。 預設值為 10。

類型:	Nullable<T>[Int32]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

類型:	SwitchParameter
別名:	cf
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Context

Azure 記憶體內容物件

類型:	IStorageContext
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-DefaultProfile

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

類型:	IAzureContextContainer
別名:	AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisAllowTrailingDot

不允許尾端點 （.） 後置詞目錄和檔名。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-FileHandle

要關閉的檔案句柄。

類型:	PSFileHandle
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-PassThru

傳回已關閉檔句柄的計數。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Path

現有檔案/目錄的路徑。

類型:	String
Position:	1
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Recursive

清單會以遞歸方式處理。 僅適用於檔案目錄。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ServerTimeoutPerRequest

伺服器會以秒為單位針對每個要求逾時。

類型:	Nullable<T>[Int32]
別名:	ServerTimeoutPerRequestInSeconds
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ShareClient

ShareClient 物件指出共用，其中包含要關閉句柄的檔案/目錄。

類型:	ShareClient
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-ShareDirectoryClient

ShareDirectoryClient 物件指出基底資料夾，其中包含要關閉句柄的檔案/目錄。

類型:	ShareDirectoryClient
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-ShareFileClient

ShareFileClient 物件指出要關閉句柄的檔案。

類型:	ShareFileClient
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-ShareName

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

類型:	String
Position:	0
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:	SwitchParameter
別名:	wi
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

ShareClient

ShareDirectoryClient

ShareFileClient

PSFileHandle

IStorageContext

輸出

Int32