你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Close-AzStorageFileHandle

模块:

Az.Storage

关闭文件共享、文件目录或文件的文件句柄。

语法

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>]

说明

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

-Directory

CloudFileDirectory 对象指示将列出文件/目录的基文件夹。

类型:	CloudFileDirectory
别名:	CloudFileDirectory
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-DisAllowTrailingDot

禁止尾随点 （.） 后缀目录和文件名。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-File

CloudFile 对象指示要关闭句柄的文件。

类型:	CloudFile
别名:	CloudFile
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	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

-Share

CloudFileShare 对象指示将列出文件/目录的共享。

类型:	CloudFileShare
别名:	CloudFileShare
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-ShareClient

ShareClient 对象指示包含要关闭句柄的文件/目录的共享。

类型:	ShareClient
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-ShareDirectoryClient

ShareDirectoryClient 对象指示包含要关闭句柄的文件/目录的基文件夹。

类型:	ShareDirectoryClient
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-ShareFileClient

ShareFileClient 对象指示要关闭句柄的文件。

类型:	ShareFileClient
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-ShareName

将列出文件/目录的文件共享的名称。

类型:	String
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

CloudFileShare

CloudFileDirectory

IStorageContext

输出

CloseFileHandleResultSegment