Set-FileLabel

Modül:: PurviewInformationProtection Module

Bir dosyanın duyarlılık etiketini ve korumasını, etiket yapılandırmasına veya özel izinlerine göre el ile etiketleme veya otomatik etiketleme yoluyla ayarlar.

Syntax

SetLabel

Set-FileLabel
    [-Path] <String[]>
    -LabelId <Guid>
    [-JustificationMessage <String>]
    [-Owner <String>]
    [-PreserveFileDetails]

SetLabelCustom

Set-FileLabel
    [-Path] <String[]>
    -LabelId <Guid>
    -CustomPermissions <AIPCustomPermissions>
    [-JustificationMessage <String>]
    [-Owner <String>]
    [-PreserveFileDetails]

Custom

Set-FileLabel
    [-Path] <String[]>
    -CustomPermissions <AIPCustomPermissions>
    [-Owner <String>]
    [-PreserveFileDetails]

SetAutoLabel

Set-FileLabel
    [-Path] <String[]>
    [-JustificationMessage <String>]
    [-Owner <String>]
    [-Force]
    [-PreserveFileDetails]
    [-AutoLabel]

WhatIf

Set-FileLabel
    [-Path] <String[]>
    [-PreserveFileDetails]
    [-WhatIf]
    [-DiscoveryInfoTypes <String[]>]

Description

Microsoft Purview Information Protection istemcisi için Set-FileLabel cmdlet'i bir veya daha fazla dosya için duyarlılık etiketi ayarlar. Etiketler şifreleme uygulamak üzere yapılandırıldığında bu eylem otomatik olarak koruma uygulayabilir.

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

Komut başarıyla çalıştırıldığında, mevcut herhangi bir 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

Get-FileStatus -Path \\Finance\Projects\ |
    Where-Object {$_.IsLabeled -eq $False} |
    Set-FileLabel -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 önce Get-FileStatus cmdlet'ini kullanarak etiketlenmemiş tüm dosyaları tanımlar. Ardından, bu dosyalar kimliğine göre "Genel" etiketi belirtilerek etiketlenir.

Örnek 2: Etiketlenmemiş .docx dosyalarına "Genel" etiketini uygulama

Get-ChildItem C:\Projects\*.docx -File -Recurse |
    Get-FileStatus |
    Where-Object {$_.IsLabeled -eq $False} |
    Set-FileLabel -LabelId d9f23ae3-1234-1234-1234-f515f824c57b

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

Bu komut önce .docx kullanarak klasördeki C:\Projects (ve alt klasörlerindeki) tüm dosyaları tanımlar, ardından bu dosyalardan cmdlet kullanılarak Get-FileStatus etiketlenmemiş olanları bulur. Elde edilen dosyalar daha sonra kimliğine göre Genel etiketi belirtilerek etiketlenir.

Uyarı

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

Örnek 3: "Genel" etiketini bir klasördeki tüm dosyalara ve alt klasörlerinden herhangi birine uygulama

Set-FileLabel -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, klasördeki tüm dosyalarda C:\Projects ve alt klasörlerinde "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), 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 amaçlanan 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: Gerekçe gerektiren "Genel" etiketini tek bir dosyaya uygulama

$setFileLabelSplat = @{
    Path = '\\Finance\Projects\Analysis.xlsx'
    LabelId = 'd9f23ae3-1324-1234-1234-f515f824c57b'
    JustificationMessage = 'The previous label no longer applies'
}
Set-FileLabel @setFileLabelSplat

FileName                          Status      Comment
--------                          ------      ------------
\\finance\projects\analysis.xlsx  Success

Bu komut, daha yüksek duyarlılık etiketiyle etiketlenmiş bir dosya için "Genel" etiketini ayarlar. Duyarlılık 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: Dosyayı özel izinlerle koruma

$newCustomPermissionsSplat = @{
    Users = 'user1@contoso.com', 'user2@vanarsdel.com'
    Permissions = 'Reviewer'
    ExpirationDate = (Get-Date -Month 1 -Day 1 -Year 2020)
}
$permissions = New-CustomPermissions @newCustomPermissionsSplat
Set-FileLabel 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 son kullanma tarihi uygular.

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

Örnek 6: Dosyaya etiket ve özel izinler uygulama

$permissions = New-CustomPermissions -Users a@a.com, b@b.com -Permissions Reviewer
$setFileLabelSplat = @{
    LabelId = 'd9f23ae3-1324-1234-1234-f515f824c57b'
    CustomPermissions = $permissions
}
Set-FileLabel @setFileLabelSplat C:\Projects\Analysis.docx

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 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ılmışsa, bunlar özel izinlerle değiştirilir.

Örnek 7: Bir klasör ağacındaki tüm dosyaları tarayın ve yapılandırılan koşullara göre etiketler uygulayın

Set-FileLabel -AutoLabel -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. Dosya Datasheet.pdf , içeriği otomatik etiketleme Analysis.xlsx için yapılandırılan koşullarla eşleşmediğinden, zaten el ile etiketlendiğinden ve daha yüksek bir etikete sahip olduğundan etiketlenmez Pricelist.xlsx . Komut Force parametresi olmadan çalıştırıldığından, varolan ve Analysis.xlsx etiketlerinin Pricelist.xlsx üzerine yazılmaz.

Uygulanan etiketler de Rights Management koruması uygulamak üzere 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), PowerShell komutunu çalıştıran kullanıcıdır.

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

Örnek 8: Bir klasör ağacındaki tüm dosyaları tarayın ve etiketleri, mevcut etiketleri geçersiz kılarak yapılandırılan koşullara göre uygulayın

Set-FileLabel -Autolabel -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 bu kez, komut Force parametresini içerdiğinden, , ve Dashboard.xlsxiçin Pricelist.xlsxvarolan etiketin de yerini alır.

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

Örnek 9: Bilinen tüm hassas bilgi türleri için bir dosyayı tarama

Set-FileLabel -AutoLabel -Path C:\Projects\Project1.docx -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 10: Belirli hassas bilgi türleri için bir dosyayı tarama

$setFileLabelSplat = @{
    AutoLabel = -AutoLabel
    Path = 'C:\Projects\Project1.docx'
    DiscoveryInfoTypes = "50842eb7-edc8-4019-85dd-5a5c1f2bb085", "a44669fe-0d48-453d-a9b1-2cc83f2cba77"
}
Set-FileLabel @setFileLabelSplat

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 dosyadaki Kredi Kartı NumarasıProject1.docx gibi belirli bilgi türlerini keşfeder.

Örnek 11: Belirli hassas bilgi türleri için bir dosyayı tarama ve bulunan değerleri görüntüleme

$setFileLabelSplat = @{
    AutoLabel = -AutoLabel
    Path = 'C:\Projects\Project1.docx'
    DiscoveryInfoTypes = '50842eb7-edc8-4019-85dd-5a5c1f2bb085',
        'a44669fe-0d48-453d-a9b1-2cc83f2cba77'
}
$x = Set-FileLabel @setFileLabelSplat
$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}

$x.MatchedInformationTypes[0].SensitiveContents | Format-List

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 dosyadaki Kredi Kartı NumarasıProject1.docx gibi belirli bilgi türlerini keşfeder. Ancak, bu örnekte sonuçlar daha fazla işlem 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ı verilmiştir.

Parametreler

-AutoLabel

-AutoLabel kullanıldığında, cmdlet otomatik etiketleme modunda çalışır. -AutoLabel cmdlet kullanılmadığında, el ile etiketleme modunda çalışır.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

SetAutoLabel

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-CustomPermissions

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

Parametre özellikleri

Tür:	AIPCustomPermissions
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

SetLabelCustom

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

Custom

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-DiscoveryInfoTypes

WhatIf parametresini kullanırken 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 numarayı Exchange Server'daki Hassas bilgi türleri bölümünde bulabilirsiniz.

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

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

WhatIf

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Force

Yapılandırılan koşullar uygulandığında mevcut bir etiketi değiştirir.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

SetAutoLabel

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-JustificationMessage

Duyarlılık ilkesi kullanıcıların bu bilgileri sağlamasını gerektiriyorsa sınıflandırma etiketini düşürmenin, etiketi kaldırmanın veya korumayı kaldırmanın gerekçe nedeni. Etiket ayarlanması gerekçeyi tetikliyorsa ve bu neden sağlanmıyorsa etiket uygulanmaz. Bu durumda, döndürülen durum "Gerekçe gerekli" açıklamasıyla "Atlandı" şeklindedir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

SetLabel

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

SetLabelCustom

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

SetAutoLabel

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-LabelId

Uygulanacak etiketin kimliğini (kimliği) belirtir. Bir etiketin alt etiketi olduğunda, her zaman üst etiketin değil, yalnızca bir alt etiketin kimliğini belirtin.

Etiket kimliğini bulmak için:

Etiket kimliği değeri Microsoft Purview uyumluluk portalında görüntülenmez. Ancak, bu değeri bulmak için aşağıdaki Office 365 Güvenlik ve 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-FileStatus cmdlet'ini de çalıştırabilirsiniz.

Parametre özellikleri

Tür:	Guid
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

SetLabel

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

SetLabelCustom

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Owner

Dosyaya etiket veya koruma uygulamak için sahip belirtir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

SetLabel

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

SetLabelCustom

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

Custom

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

SetAutoLabel

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	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 Sunucusu 2022
SharePoint Server 2019 (SharePoint Sunucusu 2019)
SharePoint Sunucusu 2016
SharePoint Sunucusu 2013

Örneğin:

C:\Folder\
C:\Folder\Filename
\\Server\Folder
http://sharepoint.contoso.com/Shared%20Documents/Folder

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

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Tam Adı, DosyaAdı

Parametre kümeleri

(All)

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	True
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-PreserveFileDetails

Etiketlediğiniz belgeler için değiştirme tarihi (Windows ve SharePoint) ve değiştirme tarihi (SharePoint) değerleri değişmeden 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.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

WhatIf

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

Girişler

System.String

Çıkışlar

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult

Notlar

Cmdlet'i Set-FileLabel bir döngüde çalıştırırken, cmdlet'ten sonra aşağıdaki komutu ekleyin:

[GC]::Collect()
[GC]::WaitForPendingFinalizers()

Bu komutlar, çöp toplayıcının artık gerekli olmayan belleği çalıştırmasını ve serbest bırakmasını sağlar.

Set-FileLabel

Syntax

SetLabel

SetLabelCustom

Custom

SetAutoLabel

WhatIf

Description

Örnekler

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

Örnek 2: Etiketlenmemiş .docx dosyalarına "Genel" etiketini uygulama

Örnek 3: "Genel" etiketini bir klasördeki tüm dosyalara ve alt klasörlerinden herhangi birine uygulama

Örnek 4: Gerekçe gerektiren "Genel" etiketini tek bir dosyaya uygulama

Örnek 5: Dosyayı özel izinlerle koruma

Örnek 6: Dosyaya etiket ve özel izinler uygulama

Örnek 7: Bir klasör ağacındaki tüm dosyaları tarayın ve yapılandırılan koşullara göre etiketler uygulayın

Örnek 8: Bir klasör ağacındaki tüm dosyaları tarayın ve etiketleri, mevcut etiketleri geçersiz kılarak yapılandırılan koşullara göre uygulayın

Örnek 9: Bilinen tüm hassas bilgi türleri için bir dosyayı tarama

Örnek 10: Belirli hassas bilgi türleri için bir dosyayı tarama

Örnek 11: Belirli hassas bilgi türleri için bir dosyayı tarama ve bulunan değerleri görüntüleme

Parametreler

-AutoLabel

Parametre özellikleri

Parametre kümeleri

-CustomPermissions

Parametre özellikleri

Parametre kümeleri

-DiscoveryInfoTypes

Parametre özellikleri

Parametre kümeleri

-Force

Parametre özellikleri

Parametre kümeleri

-JustificationMessage

Parametre özellikleri

Parametre kümeleri

-LabelId

Parametre özellikleri

Parametre kümeleri

-Owner

Parametre özellikleri

Parametre kümeleri

-Path

Parametre özellikleri

Parametre kümeleri

-PreserveFileDetails

Parametre özellikleri

Parametre kümeleri

-WhatIf

Parametre özellikleri

Parametre kümeleri

Girişler

System.String

Çıkışlar

Microsoft.InformationProtection.Powershell.AIP.Results.SetAIPFileResult

Notlar

İlişkili Bağlantılar