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 番目のコマンドでは、この変数を使用して、テンプレート名、使用権限、読み取り専用 (既定のテンプレートの
パラメーター
-ContentExpirationDate
テンプレートで保護されたコンテンツの有効期限が切れる日付を一覧表示します。
このパラメーターは、
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ContentExpirationOption
テンプレートで保護されているコンテンツのコンテンツの有効期限の構成設定を取得します。
次のいずれかの値が返されます。
しない. コンテンツが無期限に利用可能であることを示します。
OnDateを
します。 コンテンツが特定の固定日に期限切れであることを示します。 AfterDaysを
します。 コンテンツが保護された後、指定された日数だけコンテンツが使用可能であることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ContentValidityDuration
テンプレートで保護されたコンテンツの有効期限が切れる保護日から経過した日数を一覧表示します。
このパラメーターは、
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Descriptions
すべてのロケールのテンプレートの説明を一覧表示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-EnableInLegacyApps
部門別テンプレートをサポートしていないアプリケーションでの部門別テンプレートの動作を示します (ScopedIdentities パラメーターを参照)。
True に設定され、テンプレートが部門別テンプレートである場合、部門別テンプレートをサポートしていないアプリケーションからコンテンツを保護しようとしているすべてのユーザーは、テンプレートを表示するため、ユーザーがテンプレートのターゲット スコープのメンバーであるかどうかに関係なく、テンプレートを選択できます。
False に設定すると、ユーザーは表示されないため、ユーザーがテンプレートのターゲット スコープのメンバーであっても、部門別テンプレートをサポートしていないアプリケーションでテンプレートを選択することはできません。
この設定は、部門別テンプレートではないテンプレートには影響せず、部門別テンプレートをネイティブにサポートするアプリケーションにも影響しません。
このパラメーターは、Azure クラシック ポータルでアプリケーション互換性 を構成するときに、アプリケーションがユーザー ID をサポートしていない場合に、このテンプレートをすべてのユーザーに表示する
型: | 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 |