Set-AIPFileLabel

  • Başvuru
Modül:
AzureInformationProtection

Bir dosya için Azure Information Protection etiketini ayarlar veya kaldırır ve etiket yapılandırmasına veya özel izinlere göre korumayı ayarlar veya kaldırır.

Syntax

Set-AIPFileLabel
   -LabelId <Guid>
   [-JustificationMessage <String>]
   [-Owner <String>]
   [-PreserveFileDetails]
   [-EnableTracking]
   [-Path] <String[]>
   [<CommonParameters>]
Set-AIPFileLabel
   -LabelId <Guid>
   [-JustificationMessage <String>]
   -CustomPermissions <AIPCustomPermissions>
   [-Owner <String>]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]
Set-AIPFileLabel
   [-JustificationMessage <String>]
   [-RemoveLabel]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]
Set-AIPFileLabel
   [-JustificationMessage <String>]
   [-RemoveLabel]
   [-RemoveProtection]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]
Set-AIPFileLabel
   [-JustificationMessage <String>]
   [-RemoveProtection]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]
Set-AIPFileLabel
   -CustomPermissions <AIPCustomPermissions>
   [-Owner <String>]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]

Description

AIP birleşik etiketleme istemcisi için Set-AIPFileLabel cmdlet'i bir veya daha fazla dosya için duyarlılık etiketi ayarlar veya kaldırır. Bu eylem, etiketler şifreleme uygulamak üzere yapılandırıldığında otomatik olarak koruma uygulayabilir.

Ayrıca, New-AIPCustomPermissions cmdlet'iyle geçici bir koruma ilkesi nesnesi olarak oluşturulduklarında özel izinler uygulamak için bu cmdlet'i kullanabilirsiniz.

Komut başarıyla çalıştırıldığında, mevcut tüm etiket veya koruma değiştirilebilir.

Bu cmdlet'i etkileşimli olmayan bir şekilde çalıştırabilirsiniz. Daha fazla bilgi için birleşik etiketleme istemcisi yönetici kılavuzuna bakın.

Not

Set-AIPFileLabel cmdlet'ini bir döngüde çalıştırırken, cmdlet'inden sonra şu iki satırı ekleyin: [GC]::Collect()
[GC]::WaitForPendingFinalizers()

Örnekler

Örnek 1: Şu anda etiketi olmayan tüm dosyalara "Genel" etiketini uygulama

PS C:\> Get-AIPFileStatus -Path \\Finance\Projects\ | where {$_.IsLabeled -eq $False} | Set-AIPFileLabel -LabelId d9f23ae3-4321-4321-4321-f515f824c57b
FileName                              Status Comment
--------                              ------ ------------
\\Finance\Projects\Image.jpg          Success
\\Finance\Projects\Pricelist.pdf      Success
\\Finance\Projects\Announcement.docx  Success
\\Finance\Projects\Analysis.xlsx      Success

Bu komut ilk olarak Get-AIPFileStatus cmdlet'i kullanılarak etiketlenmemiş tüm dosyaları tanımlar. Ardından, bu dosyalar kimliğine göre "Genel" etiketi belirtilerek etiketlenir.

Örnek 2: Etiketlenmemiş .docx dosyalara "Genel" etiketini uygulama

PS C:\> Get-ChildItem C:\Projects\*.docx -File -Recurse | Get-AIPFileStatus | where {$_.IsLabeled -eq $False} | Set-AIPFileLabel -LabelId d9f23ae3-1234-1234-1234-f515f824c57b
FileName                   Status  Comment
--------                   ------  ------------
C:\Projects\Analysis.docx  Success
C:\Projects\Projects.docx  Success

Bu komut önce Get-Child-Item kullanarak C:\Projects klasöründeki (ve alt klasörlerindeki) tüm .docx dosyalarını tanımlar, ardından bu dosyalardan Get-AIPFileStatus cmdlet'ini kullanarak etiketlenmemiş dosyaları bulur. Sonuçta elde edilen dosyalar, kimliğine göre "Genel" etiketi belirtilerek etiketlenir.

Not

Bu komut, Get-Child-Item'inGet-AIPFileStatus ile kullanılabilmesi için FullName'in Yol diğer adını kullanır.

Örnek 3: (Yalnızca birleşik etiketleme istemcisi) "Genel" etiketini bir klasördeki tüm dosyalara ve alt klasörlerinden herhangi birine uygulama

PS C:\> Set-AIPFileLabel -Path C:\Projects\ -LabelId d9f23ae3-1324-1234-1234-f515f824c57b
FileName                    Status      Comment
--------                    ------      ------------
C:\Projects\Project1.docx   Success
C:\Projects\Datasheet.pdf   Success
C:\Projects\Image.jpg       Success
C:\Projects\Analysis.xlsx   Skipped    No label to apply
C:\Projects\Dashboard.xlsx  Success

Bu komut , Projeler klasöründeki tüm dosyalara ve alt klasörlerinden herhangi birine "Genel" adlı bir etiket ayarlar.

Genel etiketi şifreleme uygulamak üzere yapılandırılmışsa, bu komutla başarıyla etiketlenen dosyalar da şifrelenir. Bu durumda, bu dosyaların Rights Management sahibi (Rights Management Tam Denetim iznine sahip olan kullanıcı) PowerShell komutunu çalıştıran kullanıcıdır.

Bu örnekte, bir dosya gerekçe gerektirdiği için etiketlenmedi (atlandı). Bu, daha yüksek sınıflandırma etiketine veya korumasına sahip bir dosyanın yanlışlıkla daha düşük bir sınıflandırma etiketiyle üzerine yazılmamasını veya korumanın kaldırılmasını sağlamak için istenen sonuç olabilir.

Bu korumayı etkinleştirmek için, Office 365 sınıflandırma etiketi ilkesi bir etiketi kaldırmak veya sınıflandırmayı düşürmek için gerekçe gerektirecek şekilde yapılandırılmalıdır. Bu komutu JustificationMessage parametresi olmadan çalıştırdığınızda ve etiket gerekçeyi tetiklediğinde, dosya "Uygulanacak etiket yok" açıklamasıyla atlanır.

Örnek 4: (Yalnızca birleşik etiketleme istemcisi) Gerekçe gerektiren "Genel" etiketini tek bir dosyaya uygulama

PS C:\> Set-AIPFileLabel -Path \\Finance\Projects\Analysis.xlsx -LabelId d9f23ae3-1324-1234-1234-f515f824c57b -JustificationMessage 'The previous label no longer applies'
FileName                          Status      Comment
--------                          ------      ------------
\\finance\projects\analysis.xlsx  Success

Bu komut, daha yüksek bir sınıflandırma etiketiyle etiketlenmiş bir dosya için "Genel" etiketini ayarlar. Office 365 sınıflandırma etiketi ilkesi, etiketi kaldırmak veya sınıflandırmayı düşürmek için gerekçe gerektirecek şekilde yapılandırılmıştır. Komut bir gerekçe iletisi içerdiğinden yeni etiket başarıyla uygulanır.

Örnek 5: (Yalnızca birleşik etiketleme istemcisi) Dosyadan etiket kaldırma

PS C:\> Set-AIPFileLabel C:\Projects\Analysis.docx -RemoveLabel -JustificationMessage 'The previous label no longer applies'

FileName                   Status Comment
--------                   ------ ------------
C:\Projects\Analysis.docx  Success

Bu komut ,C:\Projects\Analysis.docxadlı dosyadan var olan etiketi kaldırır ve zorunlu bir gerekçe iletisi belirtir.

İlgili Office 365 sınıflandırma etiketi ilke ayarı, etiketi kaldırmak veya sınıflandırmayı düşürmek için gerekçe gerektirecek şekilde etkinleştirildiğinden bu gerekçe yöntemi gereklidir.

Not

Kaldırdığınız etiket dosyanızı şablon kullanarak koruyorsa, bu komut hem etiketi hem de korumayı kaldırır.

Kaldırdığınız etiket özel izinler kullanarak dosyanızı koruyorsa, bu komut yalnızca etiketi kaldırır.

Örnek 6: (Yalnızca birleşik etiketleme istemcisi) Dosyayı özel izinlerle koruma

PS C:\> $permissions = New-AIPCustomPermissions -Users user1@contoso.com, user2@vanarsdel.com -Permissions Reviewer -ExpirationDate (Get-Date -Month 1 -Day 1 -Year 2020)
PS C:\> Set-AIPFileLabel C:\Projects\Analysis.docx -CustomPermissions $permissions

FileName                   Status Comment
--------                   ------ ------------
C:\Projects\Analysis.docx  Success

İlk komut, farklı kuruluşlardaki kullanıcılara Gözden Geçiren izinlerinden kullanım hakları veren geçici bir koruma ilkesi nesnesi oluşturur ve ayrıca bir son kullanma tarihi uygular.

İkinci komut, depolanan geçici koruma ilkesi nesnesindeki özel izinleri kullanarak Analysis.docx adlı tek bir dosyayı korur.

Örnek 7: (Yalnızca birleşik etiketleme istemcisi) Dosyaya etiket ve özel izinler uygulama

PS C:\> $permissions = New-AIPCustomPermissions -Users a@a.com, b@b.com -Permissions Reviewer 
PS C:\> Set-AIPFileLabel C:\Projects\Analysis.docx -LabelId d9f23ae3-1324-1234-1234-f515f824c57b -CustomPermissions $permissions

FileName                   Status Comment
--------                   ------ ------------
C:\Projects\Analysis.docx  Success

İlk komut, farklı kuruluşlardaki kullanıcılara Gözden Geçiren izinlerinden kullanım hakları veren geçici bir koruma ilkesi nesnesi oluşturur ve ayrıca bir son kullanma tarihi uygular.

İkinci komut ,Analysis.docx adlı tek bir dosyaya etiket uygular ve ayrıca depolanan geçici koruma ilkesi nesnesindeki özel izinleri kullanarak dosyayı korur. Etiket koruma ayarları için yapılandırıldıysa, bunlar özel izinlerle değiştirilir.

Örnek 8: (Yalnızca birleşik etiketleme istemcisi) Dosyadan korumayı kaldırma

PS C:\> Set-AIPFileLabel C:\Projects\Analysis.docx -RemoveProtection

FileName                   Status Comment
--------                   ------ ------------
C:\Projects\Analysis.docx  Success

Bu komut ,Analysis.docxadlı tek bir dosyadan korumayı kaldırır.

Örnek 9: (Yalnızca birleşik etiketleme istemcisi) Dosyadan korumayı ve etiketi kaldırma

PS C:\> Set-AIPFileLabel C:\Projects\Analysis.docx -RemoveProtection -RemoveLabel -JustificationMessage 'The previous label no longer applies'

FileName                   Status Comment
--------                   ------ ------------
C:\Projects\Analysis.docx  Success

Bu komut etiketi ve özel korumayı Analysis.docxadlı tek bir dosyadan kaldırır. İlke bir etiketi kaldırmak için gerekçe gerektirecek şekilde yapılandırıldığından, komutun kullanıcıdan nedenini sormadan tamamlayabilmesi için gerekçe nedeni de sağlanır.

Parametreler

-CustomPermissions

New-AIPCustomPermissions cmdlet'i kullanılarak oluşturulan geçici koruma ilkesini depolayan değişken adını belirtir. Geçici koruma ilkesi, dosyayı veya dosyaları özel izinlerle korumak için kullanılır.

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

-EnableTracking

Korumalı bir belgeyi belge izleme portalına kaydetmek için bu parametreyi belirtin.

Bu cmdlet'i çalıştıran kullanıcı ve genel yöneticiler korumalı belgeyi izleyebilir ve gerekirse iptal edebilir. Belge izleme sitesi hakkında daha fazla bilgi için yönetici kılavuzundaki Azure Information Protection için belge izlemeyi yapılandırma ve kullanma bölümüne bakın.

Etiket koruma uygulamazsa, bu parametre yoksayılır.

Type:SwitchParameter
Position:named
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JustificationMessage

Azure Information Protection ilkesi kullanıcıların bu bilgileri sağlamasını gerektiriyorsa sınıflandırma etiketini düşürmek, etiketi kaldırmak veya korumayı kaldırmak için gerekçe. Etiket ayarlanması gerekçeyi tetikliyorsa ve bu neden sağlanmıyorsa etiket uygulanmaz. Bu durumda, "Gerekçe gerekli" açıklamasıyla birlikte "Atlandı" durumu döndürülür.

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

-LabelId

Uygulanacak etiketin kimliğini (ID) belirtir. Etikette alt etiket varsa, her zaman üst etiketin değil, yalnızca alt etiketin kimliğini belirtin.

Etiket kimliğini bulmak için:

Etiket kimliği değeri Microsoft 365 Uyumluluk merkezinde görüntülenmez. Ancak, bu değeri bulmak için aşağıdaki Office 365 Güvenlik & Uyumluluk Merkezi PowerShell komutunu kullanabilirsiniz:Get-Label | Format-Table -Property DisplayName, Name, Guid

Etiket uygulanmış dosyalar için etiket kimliğini (MainLabelId veya SubLabelId) tanımlamak için Get-AIPFileStatus cmdlet'ini de çalıştırabilirsiniz.

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

-Path

Etiket ve koruma bilgilerini almak istediğiniz dosyaların yerel yolunu, ağ yolunu veya SharePoint Server URL'sini belirtir.

Joker karakterler desteklenmez ve WebDav konumları desteklenmez.

SharePoint yolları için aşağıdakiler desteklenir:

  • SharePoint Server 2019
  • SharePoint Server 2016
  • SharePoint Server 2013

Örnek:

Yol değerini tırnak içine aldığınızda yollar boşluk içerebilir.

Type:String[]
Aliases:FullName, FileName
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PreserveFileDetails

Etiketlediğiniz belgeler için değiştirme tarihi (Windows ve SharePoint) ve değiştirme tarihi (SharePoint) değerlerini değiştirmeden bırakmak için bu parametreyi belirtin:

  • Yerel veya ağ dosyaları için Değiştirme tarihi değeri değişmeden kalır.

  • SharePoint dosyaları için Değiştirme tarihi ve Değiştirme tarihi değerleri değişmeden kalır.

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

-RemoveLabel

Dosyaya uygulanmış olan tüm etiketleri kaldırır.

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

-RemoveProtection

İlgili: Yalnızca birleşik etiketleme istemcisi

Bir dosyadan korumayı kaldırır. Dosya etiketliyse, etiket kaldırılmaz.

Dosyaların korumasını kaldırmak için kuruluşunuzun yeterli kullanım haklarına sahip olmanız veya süper kullanıcı olmanız gerekir. Daha fazla bilgi için bkz. Azure Rights Management ve bulma hizmetleri ya da veri kurtarma için süper kullanıcılar yapılandırma.

Kapsayıcı dosyalarından (zip, .rar, .7z ve .pst) korumanın kaldırılmasını etkinleştirmek için Set-AIPFileLabel PowerShell cmdlet'ini kullanın.

Not

  • Bu korumayı kaldırma özelliği varsayılan olarak devre dışıdır ve önce Set-LabelPolicy cmdlet'i kullanılarak etkinleştirilmesi gerekir.

  • .pst dosyaları için, bu cmdlet'le desteklenen en büyük dosya boyutu 5 GB'tır.

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

Girişler

System.String[]

Çıkışlar

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult