Set-AIPFileLabel

Sözdizimi

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.

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

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

Ö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

-EnableTracking

-JustificationMessage

-LabelId

-Path

-PreserveFileDetails

-RemoveLabel

-RemoveProtection

Girişler

System.String[]

Çıkışlar

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult

İlişkili Bağlantılar

• Get-AIPFileStatus
• New-AIPCustomPermissions
• Set-AIPFileClassification
• Set-AIPAuthentication