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 コマンドレットは、ファイル共有、ファイル ディレクトリ、またはファイルのファイル ハンドルを閉じます。

例

例 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

バックグラウンドでコマンドレットを実行する

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ClientTimeoutPerRequest

各要求のクライアント側の最大実行時間 (秒単位)。

型:	Nullable<T>[Int32]
Aliases:	ClientTimeoutPerRequestInSeconds
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-CloseAll

すべてのファイル ハンドルを強制的に閉じます。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ConcurrentTaskCount

同時実行非同期タスクの合計量。 既定値は 10 です。

型:	Nullable<T>[Int32]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Context

Azure Storage Context オブジェクト

型:	IStorageContext
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-DefaultProfile

Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。

型:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Directory

CloudFileDirectory オブジェクトは、ファイル/ディレクトリが一覧表示されるベース フォルダーを示しました。

型:	CloudFileDirectory
Aliases:	CloudFileDirectory
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-DisAllowTrailingDot

末尾のドット (.) をディレクトリ名とファイル名にサフィックス付けしないようにします。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-File

CloudFile オブジェクトは、ハンドルを閉じるファイルを示しました。

型:	CloudFile
Aliases:	CloudFile
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-FileHandle

閉じるファイル ハンドル。

型:	PSFileHandle
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-PassThru

閉じたファイル ハンドルの数を返します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Path

既存のファイル/ディレクトリへのパス。

型:	String
配置:	1
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Recursive

リスト ハンドルを再帰的に処理します。 ファイル ディレクトリでのみ機能します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ServerTimeoutPerRequest

各要求のサーバー タイムアウト (秒単位)。

型:	Nullable<T>[Int32]
Aliases:	ServerTimeoutPerRequestInSeconds
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Share

CloudFileShare オブジェクトは、ファイル/ディレクトリが一覧表示される共有を示しました。

型:	CloudFileShare
Aliases:	CloudFileShare
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-ShareClient

ShareClient オブジェクトは、閉じたハンドルに対するファイル/ディレクトリを含む共有を示しました。

型:	ShareClient
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-ShareDirectoryClient

ShareDirectoryClient オブジェクトは、閉じたハンドルのファイル/ディレクトリを含むベース フォルダーを示しました。

型:	ShareDirectoryClient
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-ShareFileClient

ShareFileClient オブジェクトは、ハンドルを閉じるファイルを示しました。

型:	ShareFileClient
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-ShareName

ファイル/ディレクトリが一覧表示されるファイル共有の名前。

型:	String
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

CloudFileShare

CloudFileDirectory

IStorageContext

出力

CloseFileHandleResultSegment