Get-AipServiceTemplateProperty

Referensi

Modul:: AIPService

Mendapatkan properti templat perlindungan untuk Azure Information Protection.

Sintaks

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

Deskripsi

Cmdlet Get-AipServiceTemplateProperty mendapatkan properti tertentu dari templat perlindungan untuk Azure Information Protection, dengan menggunakan parameter TemplateId.

Informasi konfigurasi serupa juga dapat dilihat di portal Azure, tetapi cmdlet ini juga menyertakan GUID templat.

Anda bisa mengkueri properti templat default, atau templat kustom. Untuk informasi selengkapnya tentang templat kustom, termasuk cara mengonfigurasinya di portal Azure, lihat Mengonfigurasi dan mengelola templat untuk Azure Information Protection.

Menggunakan klien pelabelan terpadu Azure Information Protection?

Klien pelabelan terpadu Azure Information Protection menggunakan templat perlindungan secara tidak langsung. Jika Anda memiliki klien pelabelan terpadu, kami sarankan Anda menggunakan cmdlet berbasis label alih-alih memodifikasi templat perlindungan Anda secara langsung.

Untuk informasi selengkapnya, lihat Membuat dan menerbitkan label sensitivitas dalam dokumentasi Microsoft 365.

Contoh

Contoh 1: Mendapatkan deskripsi dan hak penggunaan untuk templat

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

Perintah ini mendapatkan deskripsi dan hak penggunaan untuk semua pengguna atau grup yang dikonfigurasi untuk templat perlindungan yang ditentukan.

Contoh 2: Untuk semua templat, dapatkan nama, hak penggunaan, apakah templat default, dan apakah dipublikasikan atau diarsipkan

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

Perintah pertama mendapatkan semua ID templat dan menyimpannya dalam variabel. Perintah kedua kemudian menggunakan variabel ini untuk mendapatkan nama templat, hak penggunaan, apakah itu baca-saja (True untuk templat default, False untuk templat kustom), dan status (Diterbitkan atau Diarsipkan) untuk setiap templat.

Parameter

-ContentExpirationDate

Mencantumkan tanggal konten yang dilindungi dengan templat kedaluwarsa.

Gunakan parameter ini hanya jika ContentExpirationOption diatur ke OnDate.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContentExpirationOption

Mendapatkan pengaturan konfigurasi kedaluwarsa konten untuk konten yang dilindungi dengan templat.

Salah satu nilai berikut dikembalikan:

Tidak pernah. Menunjukkan bahwa konten tersedia tanpa batas waktu.
OnDate. Menunjukkan bahwa konten kedaluwarsa pada tanggal tetap tertentu.
AfterDays. Menunjukkan bahwa konten tersedia untuk jumlah hari yang ditunjukkan setelah dilindungi.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContentValidityDuration

Mencantumkan jumlah hari sejak hari perlindungan setelah konten yang dilindungi dengan templat kedaluwarsa.

Gunakan parameter ini hanya jika ContentExpirationOption diatur ke AfterDays.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Descriptions

Mencantumkan deskripsi untuk templat di semua lokal.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableInLegacyApps

Menunjukkan perilaku templat departemen dalam aplikasi yang tidak mendukung templat departemen (lihat parameter ScopedIdentities ).

Jika diatur ke True dan templat adalah templat departemen, semua pengguna yang mencoba melindungi konten dari aplikasi yang tidak mendukung templat departemen akan melihat templat dan oleh karena itu dapat memilihnya, terlepas dari apakah pengguna adalah anggota cakupan target templat atau tidak.

Jika diatur ke False, tidak ada pengguna yang melihat dan oleh karena itu tidak dapat memilih templat dalam aplikasi yang tidak mendukung templat departemen, bahkan jika pengguna adalah anggota cakupan target templat.

Pengaturan ini tidak berpengaruh pada templat yang bukan templat departemen dan juga tidak berpengaruh pada aplikasi yang secara asli mendukung templat departemen.

Parameter ini secara fungsional setara dengan kotak centang Tampilkan templat ini kepada semua pengguna ketika aplikasi tidak mendukung identitas pengguna saat Anda mengonfigurasi KOMPATIBILITAS APLIKASI di portal klasik Azure (sekarang dihentikan). Tidak ada pengaturan yang setara dalam portal Azure.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LicenseValidityDuration

Mencantumkan jumlah hari konten dapat diakses secara offline setelah lisensi untuk menggunakannya diperoleh.

-1 menunjukkan akses tak terbatas.

0 menunjukkan bahwa lisensi harus diperoleh untuk setiap penggunaan dan konten tersebut hanya tersedia secara online.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Names

Mencantumkan nama untuk templat di semua lokal.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ReadOnly

Menunjukkan apakah templat adalah templat default (True) dan oleh karena itu tidak dapat diedit atau dihapus, atau templat kustom (False) dan oleh karena itu dapat diedit atau dihapus oleh administrator.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RightsDefinitions

Mencantumkan hak yang diberikan kepada pengguna atau grup untuk konten yang dilindungi dengan templat.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScopedIdentities

Mencantumkan pengguna berdasarkan alamat email (akun atau grup) yang dapat melihat dan karenanya memilih templat departemen dari aplikasi.

Agar pengguna yang ditentukan dapat melihat templat, aplikasi harus mendukung templat departemen atau parameter EnableInLegacyApps harus diatur ke True.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Status

Status templat:

-Templat yang diarsipkan tersedia untuk menggunakan konten yang dilindungi sebelumnya tetapi tidak ditampilkan kepada pengguna.

-Templat yang diterbitkan tersedia bagi pengguna untuk melindungi konten.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TemplateId

Menentukan GUID templat perlindungan.

Anda dapat menggunakan cmdlet Get-AipServiceTemplate untuk mendapatkan ID templat dari semua templat.

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False