Set-AipServiceTemplateProperty
Azure Information Protection için bir koruma şablonunun özelliklerini veya özelliklerini güncelleştirir.
Sözdizimi
Set-AipServiceTemplateProperty
-TemplateId <Guid>
[-Names <Hashtable>]
[-Descriptions <Hashtable>]
[-RightsDefinitions <System.Collections.Generic.List`1[Microsoft.RightsManagementServices.Online.Admin.TemplateRightsDefinition]>]
[-ContentExpirationOption <ContentExpirationType>]
[-ContentExpirationDate <DateTime>]
[-ContentValidityDuration <Int32>]
[-LicenseValidityDuration <Int32>]
[-Status <TemplateStatus>]
[-ScopedIdentities <System.Collections.Generic.List`1[System.String]>]
[-EnableInLegacyApps <Boolean>]
[<CommonParameters>]
Description
Set-AipServiceTemplateProperty cmdlet'i, Azure Information Protection için bir koruma şablonunun özelliklerini veya özelliklerini güncelleştirir. Bu özelliklerin çoğunu Azure portalında güncelleştirebilirsiniz.
Bu cmdlet'i kullandığınızda, şablon, mevcut bir koruma şablonuna başvurması gereken GUID'siyle tanımlanır. Varsayılan şablonları güncelleştirmek için bu cmdlet'i kullanamazsınız.
Şablon kimliğini almak için Get-AipServiceTemplate cmdlet'ini
Önemli
Bir koruma şablonunun özelliklerini güncelleştirdiğinizde, bu özelliklerin mevcut ayarlarının üzerine uyarı olmadan yazılır (eklenmez), bu nedenle güncelleştirdiğiniz özellikler için ihtiyacınız olan tüm ayarları belirttiğinizden emin olun.
En iyi yöntem olarak, bu cmdlet'i çalıştırmadan önce Export-AipServiceTemplate cmdlet'ini kullanarak mevcut şablonu yedekleyin. Ardından, özgün yapılandırmaya geri dönmeniz gerekiyorsa, şablonu geri yüklemek için import-AipServiceTemplate cmdlet'ini
Azure portalında yapılandırma da dahil olmak üzere koruma şablonları hakkında daha fazla bilgi için bkz. Azure Information Protection için şablonları yapılandırma ve yönetme.
Azure Information Protection birleşik etiketleme istemcisini kullanma ?
Azure Information Protection birleşik etiketleme istemcisi, koruma şablonlarını dolaylı olarak kullanır. Birleşik etiketleme istemciniz varsa, koruma şablonlarınızı doğrudan değiştirmek yerine etiket tabanlı cmdlet'ler kullanmanızı öneririz.
Daha fazla bilgi için Microsoft 365 belgelerindeki Duyarlılık etiketleri oluşturma ve yayımlama
Örnekler
Örnek 1: Şablonun durumunu güncelleştirme
PS C:\>Set-AipServiceTemplateProperty -TemplateID 28168524-29c3-44f1-9e11-ea6c60bb6428 -Status Published
Bu komut, bir şablon durumunu Yayımlanan
Örnek 2: Koruma şablonu için kullanıcıları ve hakları belirtme
PS C:\> $r1 = New-AipServiceRightsDefinition -EmailAddress marketing@contoso.com -Rights "VIEW","EXPORT"
PS C:\> $r2 = New-AipServiceRightsDefinition -EmailAddress engineering@contoso.com -Rights "VIEW"
PS C:\>Set-AipServiceTemplateProperty -TemplateID 28168524-29c3-44f1-9e11-ea6c60bb6522 -RightsDefinitions ($r1, $r2)
Bu örnek, yeni kullanıcılar ve haklar için Yeni Başlat - Gizli İçerik
RightsDefinitions parametresi belirtildiğinde mevcut ayarların üzerine yazılır, ilk hak tanımı nesnesi pazarlama için mevcut ayarları korur ve başka bir hak tanımı nesnesi yeni mühendislik departmanı haklarını oluşturur.
Örnek 3: Koruma şablonuna yeni kullanıcılar ve haklar ekleme
PS C:\> $templateid = "7b1db17a-cb1a-41cf-bad7-b452f9d384c1"
PS C:\> [array]$r = New-AipServiceRightsDefinition -EmailAddress pattiful@contoso.com -Rights "DOCEDIT", "EXTRACT"
PS C:\> $r += New-AipServiceRightsDefinition -EmailAddress evannar@vanarsdelltd.com -Rights "VIEW"
PS C:\> $CurrentRightsDefinitions = [array]((get-AipServiceTemplate -TemplateId $templateid).RightsDefinitions)
PS C:\> $ResultingRightsDefinitions = $CurrentRightsDefinitions + $r
PS C:\> Set-AipServiceTemplateProperty -TemplateId $templateid -RightsDefinition $ResultingRightsDefinitions
Bu komut kümesi, şablonda zaten tanımlanmış olan kullanıcıların ve hakların üzerine yazmadan mevcut bir şablona iki yeni kullanıcı ve bunların farklı haklarını ekler.
Yeni kullanıcılar ve hakları, DOCEDIT
Parametreler
-ContentExpirationDate
Şablonla korunan içeriğin süresinin dolduğu tarihi belirtir.
Bu parametreyi yalnızca ContentExpirationOptionOnDateolarak ayarlandıysa kullanın.
Tür: | DateTime |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ContentExpirationOption
Şablonla korunan içerik için içerik süre sonu türünü belirtir.
Bu parametre için kabul edilebilir değerler şunlardır:
- Asla. İçeriğin süresiz olarak kullanılabilir olduğunu gösterir.
- OnDate
. İçeriğin süresinin belirli bir sabit tarihte dolduğunu gösterir. - AfterDays. İçeriğin korunduktan sonraki belirtilen gün sayısı için kullanılabilir olacağını gösterir.
Tür: | ContentExpirationType |
Kabul edilen değerler: | Never, OnDate, AfterDays |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ContentValidityDuration
Şablonla korunan içeriğin süresinin dolmasına ilişkin korumanın ilk gününden sonraki gün sayısını belirtir.
Bu parametreyi yalnızca
Tür: | Int32 |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Descriptions
Şablon için açıklamaların listesini belirtir.
Windows PowerShell'de karma tablo söz dizimini kullanarak birden çok yerel ayar kimlikleri için adlar ve açıklamalar oluşturun. En az bir ad/açıklama çifti olmalıdır. Adlar ve açıklamalar için yerel ayar kimlikleri birbiriyle eşleşmelidir.
$descriptions = @{}
$descriptions[1033] = "Bu içerik gizlidir ve harici olarak paylaşılmamalıdır"
$descriptions[1034] = "Este contenido es confidencial y no debe ser compartido fuera de la organizacion"
Tür: | Hashtable |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-EnableInLegacyApps
Departman şablonlarını desteklemeyen istemci uygulamalarında departman şablonunun davranışını belirler. Bu senaryo için, tüm kullanıcıların kullanılabilir şablonlar listesinden departman şablonlarını mı yoksa hiçbir kullanıcının listede bölüm şablonlarını mı göremeyeceğine karar verin.
Departman şablonları, ScopedIdentities parametresi kullanılarak veya Azure Information Protection için kapsamlı bir ilkede koruma ayarları oluşturularak oluşturulabilir. Departman şablonları klasik Azure portalı kullanılarak da oluşturulmuş olabilir (artık kullanımdan kaldırılmıştır).
True
olarak ayarlanırsa ve şablon bir departman şablonuysa, tüm kullanıcılar şablonu görür ve bu nedenle, kullanıcıların şablonun kapsamına üye olup olmadığına bakılmaksızın şablonu seçebilir. False
olarak ayarlanırsa, kullanıcılar şablonun hedef kapsamına üye olsalar bile hiçbir kullanıcı şablonu göremez ve bu nedenle seçemez.
Bu ayarın departman şablonları olmayan şablonlar üzerinde hiçbir etkisi yoktur ve ayrıca departman şablonlarını yerel olarak destekleyen istemci uygulamaları üzerinde hiçbir etkisi yoktur. Bu ayarın, şirket içi Exchange yerine Exchange Online kullanan web üzerinde Outlook için de bir etkisi yoktur ve bu senaryoda departman şablonları hiçbir zaman kullanıcılara görüntülenmez.
Bu ayarın, bir kullanıcının departman şablonu tarafından korunan içeriğe erişip erişemeyeceğini etkilemediğini unutmayın; yalnızca kullanıcının görmesi ve bu nedenle şablonun kendisini seçmesi özelliğini etkiler.
Departman şablonlarını varsayılan olarak desteklemeyen uygulamalarınız varsa, bu şablonları yerel RMS istemci klasörüne dağıtmak için özel RMS şablonu indirme betiği veya diğer araçları kullanabilirsiniz. Ardından, bu uygulamalar departman şablonlarını doğru şekilde görüntüler.
Tüm şablonları indirmiş bir istemci bilgisayardan şablon dosyalarını kopyalayıp diğer bilgisayarlara yapıştırabilirsiniz.
Tür: | Boolean |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-LicenseValidityDuration
Bu şablonla korunan içerik için kullanım lisanslarının geçerlilik süresini belirtir. değeri,
Bu değerin azaltılması, iptal edilmiş veya ilkenin değiştirildiği içeriğe bu değişikliklerden sonra çok uzun süre erişilememesine yardımcı olarak belge sahiplerine daha fazla denetim sağlar.
Bu değerin artırılması, kullanıcılara İnternet ağ bağlantısı gerektirmeden içeriğe erişme özgürlüğü verir.
Sınırsız erişim belirtmek için -1kullanın.
Korumalı içeriğe her erişildiğinde bir kullanım lisansının alınması gerektiğini ve içeriğin yalnızca İnternet bağlantısıyla kullanılabilir olduğunu belirtmek için 0belirtin.
Her kuruluşun varsayılan olarak 30 gün
Kullanım lisansı geçerlilik süresi için farklı değerler olduğunda (örneğin, kiracı için bir değer ve şablon için bir değer) Azure Information Protection en kısıtlayıcı değeri kullanır.
Tür: | Int32 |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Names
Şablon için bir ad listesi belirtir.
Azure Information Protection kullanan tüm hizmetler ve uygulamalar şu karakterleri destekleyebileceğinden, ada aşağıdaki karakterlerden hiçbirini eklemeyin: < > % & / ? ; + \ : #
Windows PowerShell'de karma tablo söz dizimini kullanarak birden çok yerel ayar kimlikleri için adlar ve açıklamalar oluşturun. En az bir ad/açıklama çifti olmalıdır. Adlar ve açıklamalar için yerel ayar kimlikleri birbiriyle eşleşmelidir.
$names = @{}
$names[1033] = "Gizli içerik"
$names[1034] = "Contenido confidencial"
Tür: | Hashtable |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-RightsDefinitions
New-AipServiceRightsDefinition cmdlet'i kullanılarak belirtilen hak tanımı nesnelerinin listesini belirtir.
Bu hak tanımı nesneleri, şablonu uygulayarak korunan içeriğe tek tek kullanıcılara veya gruplara verme haklarını ifade eder.
Tür: | System.Collections.Generic.List`1[Microsoft.RightsManagementServices.Online.Admin.TemplateRightsDefinition] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-ScopedIdentities
Kullanıcıları, uygulamalardan departman şablonlarını görebilen ve bu nedenle seçebilen e-posta adresine (hesap veya grup) göre listeler.
Belirtilen kullanıcıların şablonları görebilmesi için uygulamanın departman şablonlarını desteklemesi veya EnableInLegacyApps
Tür: | System.Collections.Generic.List`1[System.String] |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-Status
Şablonun durumunu belirtir. Geçerli değerler şunlardır:
- Arşivlenmiş şablonlar, daha önce korunan içeriği kullanmak için kullanılabilir ancak kullanıcılar tarafından görülmeyebilir.
- Yayımlanan şablonlar kullanıcılara dağıtılır ve içeriği korumak için kullanılabilir hale getirilir.
Tür: | TemplateStatus |
Kabul edilen değerler: | Archived, Published |
Position: | Named |
Default value: | None |
Gerekli: | False |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |
-TemplateId
Koruma şablonunun GUID değerini belirtir.
Tür: | Guid |
Position: | Named |
Default value: | None |
Gerekli: | True |
İşlem hattı girişini kabul et: | False |
Joker karakterleri kabul et: | False |