Set-AIPFileClassification

  • Başvuru
Modül:
AzureInformationProtection

İlkede yapılandırılan koşullara uygun olarak bir dosya için Azure Information Protection etiketini otomatik oluşturmak üzere dosyayı tarar.

Sözdizimi

Set-AIPFileClassification
   [-JustificationMessage <String>]
   [-Force]
   [-PreserveFileDetails]
   [-Path] <String[]>
   [<CommonParameters>]
Set-AIPFileClassification
   [-JustificationMessage <String>]
   [-Force]
   [-WhatIf]
   [-DiscoveryInfoTypes <String[]>]
   [-Path] <String[]>
   [<CommonParameters>]

Description

Etiketleri otomatik sınıflandırma için yapılandırdığınızda Set-AIPFileClassification cmdlet'i bir veya daha fazla dosya için otomatik olarak etiket uygulayabilir.

Bu cmdlet çalıştırıldığında, dosya içeriğini inceler ve bir etiket için yapılandırılan koşullar karşılanırsa, bu etiket uygulanır. Seçili etiket koruma uygularsa bu eylem otomatik olarak koruma uygular.

Varsayılan olarak, dosyada zaten bir etiket varsa, mevcut etiket veya koruma değiştirilmez.

Dosya el ile etiketlendiği için etiketlenmediğinde, belirttiğiniz koşullarla eşleşme olmadığında veya dosya daha yüksek bir sınıflandırmaya sahip olduğunda, dosya "Uygulanacak etiket yok" tek açıklamasıyla atlanır.

Daha fazla bilgi için bkz. İçeriğe otomatik olarak duyarlılık etiketi uygulama

Cmdlet'i etkileşimli olmayan şekilde çalıştırma

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: Bir klasör ve tüm alt klasörlerindeki tüm dosyaları tarayın ve otomatik sınıflandırma için yapılandırılmış koşullara uygun olarak etiketleri uygulayın

PS C:\> Set-AIPFileClassification -Path C:\Projects\ -PreserveFileDetails


FileName      : C:\Projects\Project1.docx
Status        : Success
Comment       :
MainLabelName : Confidential
MainLabelId   : 074e257c-1234-1234-1234-34a182080e71
SubLabelName  : Finance group
SubLabelId    : d9f23ae3-1234-1234-1234-f515f824c57b

FileName      : C:\Projects\Datasheet.pdf
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Analysis.xlsx
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Pricelist.xlsx
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Dashboard.xlsx
Status        : Success
Comment       : 
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    :

Bu komut Projeler klasöründeki ve alt klasörlerinden herhangi birindeki tüm dosyaları tarar ve etiketleri otomatik etiketleme ilkesinde yapılandırılan koşullara göre ayarlar. Bu örnekte, beş dosya vardır ve iki dosya otomatik olarak etiketlenir. İçeriği otomatik sınıflandırma için yapılandırılmış koşullarla eşleşmediğinden Datasheet.pdf dosya etiketlenmez Analysis.xlsx el ile etiketlenmiştir ve Pricelist.xlsx daha yüksek bir etikete sahiptir. Komut -Force parametresi olmadan çalıştırıldığından, Analysis.xlsx ve Pricelist.xlsx için mevcut etiketlerin üzerine yazılmaz.

Uygulanan etiketler ayrıca Rights Management koruması uygulamak için yapılandırılmışsa, bu komutla başarıyla etiketlenen dosyalar da korunur. 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.

PreserveFileDetails parametresi belirtildiğinden etiketlenmiş dosyaların Değiştirilme Tarihi değişmeden kalır.

Örnek 2: Bir klasör ve tüm alt klasörlerindeki tüm dosyaları tarayın ve otomatik sınıflandırma için yapılandırılmış koşullara uygun olarak etiketleri mevcut etiketlerin üzerine yazıp uygulayın

PS C:\> Set-AIPFileClassification -Path C:\Projects\ -Force -PreserveFileDetails


FileName      : C:\Projects\Project1.docx
Status        : Success
Comment       :
MainLabelName : Confidential
MainLabelId   : 074e257c-1234-1234-1234-34a182080e71
SubLabelName  : Finance group
SubLabelId    : d9f23ae3-1234-1234-1234-f515f824c57b

FileName      : C:\Projects\Datasheet.pdf
Status        : Skipped
Comment       : No label to apply
MainLabelName : 
MainLabelId   : 
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Analysis.xlsx
Status        : Success
Comment       :
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Pricelist.xlsx
Status        : Success
Comment       :
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    : 

FileName      : C:\Projects\Dashboard.xlsx
Status        : Success
Comment       : 
MainLabelName : Public
MainLabelId   : f018e9e7-0cfc-4c69-b27a-ac3cb7df43cc
SubLabelName  : 
SubLabelId    :

Bu komut, Projeler klasöründeki ve alt klasörlerinden herhangi birindeki tüm dosyaları tarar ve otomatik etiketleme için yapılandırılan koşullara göre etiketleri ayarlar. Ancak, komutu -Force parametresini içerdiğinden, bu kez Dashboard.xlsx ve Pricelist.xlsxiçin var olan etiketin yerini alır.

Datasheet.pdf içeriği yapılandırılmış hiçbir koşulla eşleşmedi ve bu dosya etiketsiz kalır.

Örnek 3: (Yalnızca birleşik etiketleme istemcisi) Bilinen tüm hassas bilgi türleri için WhatIf modunda bir dosyayı tarama

PS C:\> Set-AIPFileClassification -Path C:\Projects\Project1.docx -WhatIf -DiscoveryInfoTypes All


MainLabelName           : General
MainLabelId             : 89a453df-5df4-4976-8191-jdn2fsf9560a
SubLabelName            :
SubLabelId              :
WhatIf                  : True
MatchedInformationTypes : {Credit Card Number, U.S. Social Security Number (SSN), International Classification of
                          Diseases (ICD-10-CM), International Classification of Diseases (ICD-9-CM)}
LastModifiedBy          :
LastModifiedTime        : 8/19/2014 5:11:26 AM
FileName                : C:\Projects\Project1.docx
Status                  : Success
Comment                 :

Bu komut, koruma veya etiket uygulamadan Project1.docx dosyasındaki tüm bilinen bilgi türlerini bulur.

Örnek 4: (Yalnızca birleşik etiketleme istemcisi) Belirli hassas bilgi türleri için WhatIf modunda bir dosyayı tarama

PS C:\> Set-AIPFileClassification -Path C:\Projects\Project1.docx -WhatIf -DiscoveryInfoTypes "50842eb7-edc8-4019-85dd-5a5c1f2bb085","a44669fe-0d48-453d-a9b1-2cc83f2cba77"

MainLabelName           : General
MainLabelId             : 89a453df-5df4-4976-8191-jdn2fsf9560a
SubLabelName            :
SubLabelId              :
WhatIf                  : True
MatchedInformationTypes : {Credit Card Number, U.S. Social Security Number (SSN)}
LastModifiedBy          :
LastModifiedTime        : 8/19/2014 5:11:26 AM
FileName                : Project1.docx
Status                  : Success
Comment                 :

Bu komut, koruma veya etiket uygulamadan Project1.docx dosyasındaki "Kredi Kartı Numarası" ve "Sosyal Güvenlik Numarası (SSN)" gibi belirli bilgi türlerini bulur.

Örnek 5: (Yalnızca birleşik etiketleme istemcisi) Belirli hassas bilgi türleri için WhatIf modunda bir dosyayı tarayın ve bulunan değerleri görüntüleyin

PS C:\> $x=Set-AIPFileClassification -Path "C:\Projects\Project1.docx" -WhatIf -DiscoveryInfoTypes "50842eb7-edc8-4019-85dd-5a5c1f2bb085","a44669fe-0d48-453d-a9b1-2cc83f2cba77"
PS C:\> $x.MatchedInformationTypes

RulePackageSetId  : 00000000-0000-0000-0000-000000000000
RulePackageId     : 00000000-0000-0000-0000-000000000000
RuleId            : 50842eb7-edc8-4019-85dd-5a5c1f2bb085
Name              : Credit Card Number
Count             : 1
UniqueCount       : 1
Confidence        : 85
SensitiveContents : {Offset: 2089, Length: 19}
 
RulePackageSetId  : 00000000-0000-0000-0000-000000000000
RulePackageId     : 00000000-0000-0000-0000-000000000000
RuleId            : a44669fe-0d48-453d-a9b1-2cc83f2cba77
Name              : U.S. Social Security Number (SSN)
Count             : 1
UniqueCount       : 1
Confidence        : 85
SensitiveContents : {Offset: 7063, Length: 11}


PS C:\> $x.MatchedInformationTypes[0].SensitiveContents | fl

Offset  : 2089
Length  : 19
Value   : 4539-9572-7949-2212
Context : OLOGICAL SCIENCES     Credit Card #
          Expiration Date:      4539-9572-7949-2212
          8/2009                Department:     BIOLOGICAL SCIENCES     Anticipa

Önceki örneğe benzer şekilde, ilk komut koruma veya etiket uygulamadan Project1.docx dosyasında "Kredi Kartı Numarası" ve "Sosyal Güvenlik Numarası (SSN)" gibi belirli bilgi türlerini bulur. Ancak, bu örnekte sonuçlar daha fazla işleme için bir değişkende depolanır.

İkinci komut daha sonra, SensitiveContents parametresini içeren eşleşen bilgi türlerinin içeriğini görüntülemek için kullanılır.

Son komut, ilk hassas bilgi türü tarafından tanımlanan verileri daha kolay okumak için görüntülenir ve biçimlendirilir; bu örnekte kredi kartı ayrıntılarıdır.

Parametreler

-DiscoveryInfoTypes

Not: Bu parametre yalnızca Azure Information Protection birleşik etiketleme istemcisiyle desteklenir.

WhatIf parametresini kullandığınızda bulunabilecek hassas bilgi türlerini belirtin.

Belirli hassas bilgi türlerini aramak istiyorsanız, bu bilgi türü için Varlık kimliği numarasını belirtin. Bu numaraya Exchange Server'deki Hassas bilgi türleri bölümünden ulaşabilirsiniz.

Örneğin, "50842eb7-edc8-4019-85dd-5a5c1f2bb085" Kredi Kartı Numarası hassas bilgi türü için belirtilmesi gereken sayıdır.

Tür:String[]
Kabul edilen değerler:All, "rule_id_1", "rule_id_2"
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Force

Yapılandırılmış koşullar uygulandığında var olan bir etiketin yerini alır.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et: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, -Force parametresi ayarlanmış olsa bile etiket uygulanmaz. Bu durumda, döndürülen durum şu açıklamayla "Atlandı" şeklindedir: "Uygulanacak etiket yok"

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

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 tarihi değiştirmeden bırakmak için bu parametreyi belirtin.

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

SharePoint dosyaları için Değiştirme tarihi ve Değiştirme Tarihi 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

-WhatIf

İlgili: Yalnızca birleşik etiketleme istemcisi

Cmdlet çalıştırılırsa ne olacağını gösterir ve tarayıcı için bulma modunun eşdeğeridir. Değişiklikler giriş veya çıkış dosyalarına uygulanmaz.

Tüm hassas bilgi türlerini veya belirli hassas bilgi türlerini aramak için DiscoveryInfoTypes ile bu parametreyi kullanın.

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

Girişler

System.String[]

Çıkışlar

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileClassificationResult