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
テンプレートで保護されているコンテンツのコンテンツ有効期限の構成設定を取得します。
以下の値のいずれかが返されます。
Never。 コンテンツは無期限に使用できることを示します。
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 クラシック ポータルで 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 |