Aracılığıyla paylaş

Remove-FileLabel

  • Başvuru
Modül:
PurviewInformationProtection

Bir dosyanın duyarlılık etiketini kaldırır veya etiket yapılandırmasına veya özel izinlerine göre korumayı kaldırır.

Sözdizimi

Remove-FileLabel
      [-Path] <String[]>
      [-JustificationMessage <String>]
      [-RemoveLabel]
      [-PreserveFileDetails]
      [<CommonParameters>]
Remove-FileLabel
      [-Path] <String[]>
      [-JustificationMessage <String>]
      [-RemoveLabel]
      [-RemoveProtection]
      [-PreserveFileDetails]
      [<CommonParameters>]
Remove-FileLabel
      [-Path] <String[]>
      [-JustificationMessage <String>]
      [-RemoveProtection]
      [-PreserveFileDetails]
      [<CommonParameters>]

Description

Microsoft Purview Bilgi Koruması istemcisi için Remove-FileLabel cmdlet'i bir veya daha fazla dosya için duyarlılık etiketini kaldırır.

Örnekler

Örnek 1: Dosyadan etiket kaldırma

PS C:\> Remove-FileLabel 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.

Bu gerekçe yöntemi gereklidir çünkü ilgili duyarlılık etiketi ilke ayarı, etiketi kaldırmak için gerekçe gerektirecek şekilde etkinleştirilmiştir.

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 8: Dosyadan korumayı kaldırma

PS C:\> Remove-FileLabel 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: 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

-JustificationMessage

Duyarlılık etiketleme ilkesi kullanıcıların bu bilgileri sağlamasını gerektiriyorsa etiketi kaldırmanın veya korumayı kaldırmanın gerekçe nedeni. Bir etiketin kaldırılması gerekçeyi tetikliyorsa ve bu neden sağlanmıyorsa, etiket kaldırılmaz. Bu durumda, "Gerekçe gerekli" açıklamasıyla birlikte "Atlandı" durumu döndürülür.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Path

Etiket ve koruma bilgilerini kaldırmak 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 2022
  • 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.

Tür:String[]
Diğer adlar:FullName, FileName
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-PreserveFileDetails

Etiketlediğiniz belgeler için değiştirme tarihini (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.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-RemoveLabel

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

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-RemoveProtection

Bir dosyadan korumayı kaldırır. Dosya etiketlenmişse, etiket kaldırılmaz.

Dosyalardan korumayı 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 Remove-FileLabel 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 ile desteklenen en büyük dosya boyutu 5 GB'tır.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

System.String[]

Çıkışlar

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult