次の方法で共有


Get-AipServiceTemplateProperty

Azure Information Protectionの保護テンプレートのプロパティを取得します。

構文

Get-AipServiceTemplateProperty
   -TemplateId <Guid>
   [-Names]
   [-Descriptions]
   [-RightsDefinitions]
   [-ContentExpirationOption]
   [-ContentExpirationDate]
   [-ContentValidityDuration]
   [-LicenseValidityDuration]
   [-ReadOnly]
   [-Status]
   [-ScopedIdentities]
   [-EnableInLegacyApps]
   [<CommonParameters>]

説明

Get-AipServiceTemplateProperty コマンドレットは、TemplateId パラメーターを使用して、Azure Information Protection の保護テンプレートの指定されたプロパティを取得します。

Azure portalでも同様の構成情報を表示できますが、このコマンドレットにはテンプレート GUID も含まれています。

既定のテンプレートまたはカスタム テンプレートのプロパティに対してクエリを実行できます。 Azure portalでカスタム テンプレートを構成する方法など、カスタム テンプレートの詳細については、「Azure Information Protection のテンプレートの構成と管理」を参照してください。

Azure Information Protection統合ラベル付けクライアントを使用しますか?

Azure Information Protection 統合ラベル付けクライアントは、保護テンプレートを間接的に使用します。 統合ラベル付けクライアントがある場合は、保護テンプレートを直接変更する代わりに、ラベルベースのコマンドレットを使用することをお勧めします。

詳細については、Microsoft 365 ドキュメントの 秘密度ラベルの作成と公開 に関するページを参照してください。

例 1: テンプレートの説明と使用権限を取得する

PS C:\>Get-AipServiceTemplateProperty -TemplateId 28168524-29c3-44f1-9e11-ea6c60bb6428 -Descriptions -RightsDefinitions

このコマンドは、指定された保護テンプレート用に構成されているすべてのユーザーまたはグループの説明と使用権限を取得します。

例 2: すべてのテンプレートについて、名前、使用権限、既定のテンプレートかどうか、公開済みかアーカイブかを取得します

PS C:\>$templates = Get-AipServiceTemplate PS C:\>foreach ($template in $templates) {Get-AipServiceTemplateProperty -TemplateId $template.TemplateId -Name -RightsDefinitions -ReadOnly -Status}

最初のコマンドは、すべてのテンプレート ID を取得し、それらを変数に格納します。 2 番目のコマンドでは、この変数を使用して、テンプレート名、使用権限、読み取り専用かどうか (既定のテンプレートの場合は True 、カスタム テンプレートの場合は False )、各テンプレートの状態 (発行 済みまたは アーカイブ済み) を取得します。

パラメーター

-ContentExpirationDate

テンプレートで保護されたコンテンツの有効期限が切れる日付を一覧表示します。

このパラメーターは 、ContentExpirationOptionOnDate に設定されている場合にのみ使用します。

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

-ContentExpirationOption

テンプレートで保護されているコンテンツのコンテンツ有効期限の構成設定を取得します。

以下の値のいずれかが返されます。

  • Never。 コンテンツは無期限に使用できることを示します。

  • OnDate。 コンテンツが特定の日付に期限切れになることを示します。

  • AfterDays。 コンテンツが保護を開始してから指定の日数使用できることを示します。

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

-ContentValidityDuration

テンプレートで保護されたコンテンツの有効期限が切れる保護の日から経過した日数を一覧表示します。

このパラメーターは 、ContentExpirationOptionAfterDays に設定されている場合にのみ使用します。

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

-Descriptions

すべてのロケールのテンプレートの説明を一覧表示します。

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

-EnableInLegacyApps

部門テンプレートをサポートしていないアプリケーションでの部門別テンプレートの動作を示します ( ScopedIdentities パラメーターを参照)。

True に設定され、テンプレートが部門別テンプレートである場合、部門別テンプレートをサポートしていないアプリケーションからコンテンツを保護しようとしているすべてのユーザーは、テンプレートを表示するため、ユーザーがテンプレートのターゲット スコープのメンバーであるかどうかに関係なく、テンプレートを選択できます。

False に設定すると、ユーザーがテンプレートのターゲット スコープのメンバーである場合でも、部門別テンプレートをサポートしていないアプリケーションでテンプレートを選択することはできません。

この設定は、部門別テンプレート以外のテンプレートには作用しません。また、部門別テンプレートをネイティブにサポートするアプリケーションにも作用しません。

このパラメーターは、機能上、Azure クラシック ポータルで APPLICATION COMPATIBILITY を構成するときにアプリケーションがユーザー ID をサポートしていない場合にこのテンプレートをすべてのユーザーに表示するチェック ボックスと同等です (現在は廃止されました)。 Azure portalに同等の設定はありません。

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

-LicenseValidityDuration

コンテンツを使用するライセンスが取得された後にオフラインでアクセスできる日数を一覧表示します。

-1 は無制限のアクセスを示します。

0 は、使用ごとにライセンスを取得する必要があり、コンテンツがオンラインでのみ利用可能であることを示します。

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

-Names

すべてのロケールのテンプレートの名前を一覧表示します。

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

-ReadOnly

テンプレートが既定のテンプレート (True) であるため、編集または削除できないか、カスタム テンプレート (False) であるため、管理者が編集または削除できるかどうかを示します。

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

-RightsDefinitions

テンプレートで保護されているコンテンツのユーザーまたはグループに付与される権限を一覧表示します。

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

-ScopedIdentities

アプリケーションから部門別テンプレートを表示して選択できるユーザーを電子メール アドレス (アカウントまたはグループ) でリストします。

指定したユーザーがテンプレートを表示するには、アプリケーションが部門別テンプレートをサポートしているか、 EnableInLegacyApps パラメーターを True に設定する必要があります。

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

-Status

テンプレートの状態:

- アーカイブされた テンプレートは、以前に保護されたコンテンツを使用できますが、ユーザーには表示されません。

- 公開された テンプレートは、ユーザーがコンテンツを保護するために使用できます。

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

-TemplateId

保護テンプレートの GUID を指定します。

Get-AipServiceTemplate コマンドレットを使用して、すべてのテンプレートのテンプレート ID を取得できます。

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