Get-FileStatus
指定したファイルまたはファイルの Microsoft Purview 情報保護ラベルと保護情報を取得します。
構文
Default (既定)
Get-FileStatus
[-Path] <String[]>
[<CommonParameters>]
説明
Get-FileStatus コマンドレットは、指定したファイルまたは指定したパス内のすべてのファイルの状態を返します。 このステータスには、ファイルにラベルがあるかどうか、ラベルがある場合はラベル名、ラベルを適用したユーザー、適用方法、および適用日時が含まれます。
ファイルが SharePoint Online に保存されている場合は、代わりに SharePointOnlinePowerShell モジュールの Get-FileSensitivityLabelInfo コマンドレットを使用します。
Get-FileStatus コマンドレットで返される状態には、ファイルが Rights Management によって保護されているかどうか、保護されている場合は、この保護を適用するために使用された Rights Management テンプレートも含まれます。 ファイルがテンプレートではなくカスタム権限 (アドホック権限ポリシー) で保護されている場合は、テンプレート名の代わりに "制限付きアクセス" と表示されます。 さらに、 Rights Management の所有者と Rights Management の発行者 、およびファイルが保護されていた日時が表示されます。
このコマンドレットは、独自のテナントからのみラベル情報を返します。
パスワードで保護されたファイルは常に False の保護ステータスを返すことに注意してください。
このコマンドレットは非対話形式で実行できます。
例
例 1: 1 つのファイルのラベルと保護状態を取得する
PS C:\> Get-FileStatus -Path \\Finance\Projects\Project.docx
FileName : \\Finance\Projects\Project.docx
IsLabeled : True
MainLabelId : 074e257c-1234-1234-1234-34a182080e71
MainLabelName : Confidential
SubLabelId : d9f23ae3-1234-1234-1234-f515f824c57b
SubLabelName : Finance group
LabelingMethod : Privileged
LabelDate : 12/12/2016 12:24:36 PM
IsRMSProtected : True
RMSTemplateId : e6ee2481-1234-1234-1234-f744eacd53b0
RMSTemplateName : Contoso - Confidential Finance
RMSOwner : John@Contoso.com
RMSIssuer : John@Contoso.com
ContentId : 4ca757d2-83bf-4ec3-b93b-c7fe9433bf33
このコマンドは、テナント用に構成されたラベルである "Confidential \ Finance group" というラベルが付けられたファイルに関する情報を提供します。 このファイルは John によって手動でラベル付けされ、Rights Management テンプレート "Contoso - Confidential Finance" を使用して保護されています。
例 2: フォルダー内のすべてのファイルのラベルと保護状態を取得し、結果を CSV ファイルにエクスポートする
PS C:\> Get-FileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\Report.csv
このコマンドは、Finance サーバー上のすべてのファイルのラベルと保護情報を取得します。これは、Projects フォルダとそのサブフォルダです。 結果は Report.csv という名前のファイルにエクスポートされるため、より簡単に検索および並べ替えることができます。 以前のレポートが C:\Reports\Report.csvに存在する場合、そのレポートは上書きされます。
例 3: 「社外秘」というラベルの付いたファイルをリストし、結果を CSV ファイルにエクスポートする
PS C:\> Get-FileStatus -Path \\Finance\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'} | Export-Csv C:\Reports\Report.csv
このコマンドは、Finance サーバー上の Projects フォルダーとそのサブフォルダー内の "Confidential" というラベル (サブラベルに関係なく) のみのラベルと保護情報を取得します。 結果は Report.csv という名前のファイルにエクスポートされるため、より簡単に検索および並べ替えることができます。 以前のレポートが C:\Reports\Report.csvに存在する場合、そのレポートは上書きされます。
例 4: "社外秘" ラベルを持つファイルの数
PS C:\> (Get-FileStatus -Path C:\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'}).Count
5
このコマンドは、 C:\Projects フォルダとそのサブフォルダにある "Confidential" ラベルの付いたファイルの数を提供します。 この例では、5 つのファイルが見つかります。
パラメーター
-Path
ラベルと保護情報を取得するファイルへのローカル パス、ネットワーク パス、または SharePoint Server URL を指定します。 ワイルドカードはサポートされていません。
SharePoint パスでは、次のものがサポートされています。
- SharePoint Server 2019
- SharePoint Server 2016
- SharePoint Server 2013
例えば次が挙げられます。
- C:\フォルダ\
- C:\Folder\ファイル名
- \\サーバー\フォルダ
http://sharepoint.contoso.com/Shared%20Documents/Folder
パス値を引用符で囲むと、パスにスペースを含めることができます。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | 氏名, ファイル名 |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。