Get-AIPFileStatus

  • リファレンス
モジュール:
AzureInformationProtection

指定したファイルの Azure Information Protection ラベルと保護情報を取得します。

構文

Get-AIPFileStatus
   [-Path] <String[]>
   [<CommonParameters>]

説明

Get-AIPFileStatus コマンドレットは、指定したファイルまたは指定したパス内のすべてのファイルの Azure Information Protection状態を返します。 この状態には、ファイルにラベルがあるかどうか、ラベル名、適用されたユーザー、適用された方法、およびタイミングが含まれます。

ファイルが SharePoint Online に格納されている場合は、代わりに SharePointOnlinePowerShell モジュールから Get-FileSensitivityLabelInfo コマンドレットを使用します。

Get-AIPFileStatus コマンドレットで返される状態には、ファイルが Rights Management によって保護されているかどうか、その場合は、この保護を適用するために使用された Rights Management テンプレートも含まれます。 テンプレートの代わりにカスタム アクセス許可 (アドホック権限ポリシー) でファイルが保護されていた場合、テンプレート名の代わりに "制限付きアクセス" が表示されます。 さらに、 Rights Management の所有者と Rights Management の発行者 が表示され、ファイルがいつ保護されたかが表示されます。

このコマンドレットは、独自のテナントからのみラベル情報を返します。

パスワードで保護されたファイルは常に保護状態 False を返します。

このコマンドレットは、対話形式で実行できません。 詳細については、統合ラベル付けクライアント管理者ガイドを参照してください。

例

例 1: 1 つのファイルのラベルと保護の状態を取得する

PS C:\> Get-AIPFileStatus -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 グループ" というラベルが付いたファイルに関する情報を提供します。これは、テナント用に構成されたラベルです。 このファイルは John によって手動でラベル付けされ、Rights Management テンプレート "Contoso - Confidential Finance" を使用して保護されます。

例 2: フォルダー内のすべてのファイルのラベルと保護の状態を取得し、結果を CSV ファイルにエクスポートする

PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\ | Export-Csv C:\Reports\AIP-status.csv

このコマンドは、Finance サーバー、Projects フォルダー、およびそのサブフォルダー内のすべてのファイルのラベルと保護情報を取得します。 結果は 、AIP-status.csv という名前のファイルにエクスポートされ、検索や並べ替えが簡単になります。 前のレポート がC:\Reports\Report.csvに存在する場合は、上書きされます。

例 3: "Confidential" というラベルのファイルを一覧表示し、結果を CSV ファイルにエクスポートする

PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\ | Where-Object {$_.MainLabelName -eq 'Confidential'} | Export-Csv C:\Reports\AIP-status.csv

このコマンドは、Finance サーバーの "Confidential" (サブラベルに関係なく) 、Projects フォルダーとそのサブフォルダーのいずれかにラベルが付いたファイルのラベルと保護情報のみを取得します。 結果は 、AIP-status.csv という名前のファイルにエクスポートされ、検索や並べ替えが簡単になります。 前のレポート がC:\Reports\Report.csvに存在する場合は、上書きされます。

例 4: "Confidential" ラベルを持つファイルの数

PS C:\> (Get-AIPFileStatus -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

次に例を示します。

パスの値を引用符で囲む場合、パスにはスペースを含めることができます。

Type:String[]
Aliases:FullName, FileName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

入力

System.String[]

出力

Microsoft.InformationProtection.Powershell.AIP.Results.GetAIPFileStatusResult