Aracılığıyla paylaş


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 kullanabilirsiniz.

Ö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 kullanabilirsiniz.

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 bakın.

Ö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ımlananolarak ayarlar.

Ö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 mevcut koruma şablonunu güncelleştirir. Mevcut şablon pazarlama departmanına Görüntüleme ve Dışarı Aktarma hakları vermişken (değişmemesi gerekir), mühendislik departmanının da Görüntüleme haklarına sahip olması gerekir.

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 verilen ve EXTRACT haklarını pattiful.contoso.com (kuruluş içindeki bir kullanıcıdır); ve VIEW hakları verilen (başka bir kuruluştan bir kullanıcı). Bu kullanıcılar ve hakları, bir dizi kullanılarak rights definition nesnelerine eklenir ve daha sonra şablon için mevcut hak tanımlarına eklenir.

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 ContentExpirationOption parametresi AfterDaysolarak ayarlanmışsa kullanın.

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.

  • Falseolarak 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,(0-9999) bir kullanım lisansı alındıktan sonra içeriğin çevrimdışı olarak kullanılabildiği gün sayısı olarak belirtilir. Bu süre boyunca kullanıcılar İnternet ağ bağlantısına gerek kalmadan daha önce erişmiş oldukları içeriği yeniden açabilir.

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 maksimum kullanım lisansı geçerlilik süresi vardır ve Set-AipServiceMaxUseLicenseValidityTimekullanılarak yapılandırılabilir. LicenseValidityDuration parametresi için belirttiğiniz değer bu değerden düşük olmalıdır.

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 parametresinin Trueolarak ayarlanması gerekir.

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: Yayımlanan veya Arşivlenmiş.

  • 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