次の方法で共有


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

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

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

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

-ContentExpirationOption

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

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

  • しない. コンテンツが無期限に利用可能であることを示します。

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

  • AfterDaysを します。 コンテンツが保護された後、指定された日数だけコンテンツが使用可能であることを示します。

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

-ContentValidityDuration

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

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

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

-Descriptions

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

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

-EnableInLegacyApps

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

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

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

この設定は、部門別テンプレートではないテンプレートには影響せず、部門別テンプレートをネイティブにサポートするアプリケーションにも影響しません。

このパラメーターは、Azure クラシック ポータルでアプリケーション互換性 を構成するときに、アプリケーションがユーザー 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