Install-Scanner

Microsoft Purview Bilgi Koruması tarayıcısını yükler.

Syntax

Default (Varsayılan)

Install-Scanner
    [-ServiceUserCredentials] <PSCredential>
    [-StandardDomainsUserAccount <PSCredential>]
    [-ShareAdminUserAccount <PSCredential>]
    [-SqlServerInstance]
    -Profile <String>
    [-FeatureSettings <Hashtable>]
    [-WhatIf]
    [-Confirm]

Description

Install-Scanner cmdlet'i, Windows Server 2022, Windows Server 2019, Windows Server 2016 veya Windows Server 2012 R2 çalıştıran bir bilgisayara Microsoft Purview Bilgi Koruması tarayıcısını yükler ve yapılandırır.

Microsoft Purview Bilgi Koruması tarayıcısı, Sunucu İleti Bloğu (SMB) protokolünü kullanan veri depolarındaki ve şirket içi SharePoint'teki dosyaları taramak için bu hizmeti kullanır. Bu tarayıcının bulduğu dosyalar daha sonra sınıflandırma uygulamak ve isteğe bağlı olarak koruma uygulamak veya korumayı kaldırmak için etiketlenebilir.

Etiketlerin ve ilke ayarlarının nasıl yapılandırılacağı hakkında daha fazla bilgi için bkz: Duyarlılık etiketlerine genel bakış

Önemli

Microsoft Purview Bilgi Koruması tarayıcısı için başka bir cmdlet çalıştırmadan önce bu cmdlet'i çalıştırmanız gerekir.

Komut, Bilgi Koruma Tarayıcısı adlı bir Windows hizmeti oluşturur. Ayrıca, tarayıcının yapılandırma ve işlem bilgilerini depolamak için SQL Server'da bir veritabanı oluşturur ve yapılandırır. Tarayıcıyı çalıştırmak için belirttiğiniz hizmete, oluşturulan veritabanını okumak ve bu veritabanına yazmak için gerekli haklar otomatik olarak verilir.

Bu komutu çalıştırmak için, Windows Server bilgisayarı için yerel yönetici haklarına ve tarayıcı için kullanacağınız SQL Server örneği üzerinde Sysadmin haklarına sahip olmanız gerekir.

Bu komutu çalıştırdıktan sonra, tarayıcı kümesindeki ayarları yapılandırmak ve taranacak veri depolarını belirtmek için Microsoft Purview uyumluluk portalı kullanın. Tarayıcıyı çalıştırmadan önce, kimlik doğrulaması ve yetkilendirme için Azure AD'de oturum açmak için Set-Authentication cmdlet'ini bir kez çalıştırmanız gerekir.

Tarayıcıyı yükleme, yapılandırma ve kullanma ile ilgili adım adım yönergeler için bkz: Bilgi koruma tarayıcısı hakkında bilgi edinme.

Örnekler

Örnek 1: Bir SQL Server örneği ve küme kullanarak Microsoft Purview Bilgi Koruması Scanner hizmetini yükleyin

PS C:\> Install-Scanner -SqlServerInstance SQLSERVER1\MIPSCANNER -Cluster EU

Bu komut, SQLSERVER1 adlı sunucuda çalışan MIPSCANNER adlı bir SQL Server örneği kullanarak Microsoft Purview Bilgi Koruması Tarayıcısı hizmetini yükler.

Buna ek olarak, aynı ada sahip varolan bir veritabanı zaten bulunmadığı sürece, yükleme tarayıcı yapılandırmasını depolamak için AIPScannerUL_< küme adı> veritabanı adını oluşturur.

Tarayıcı hizmeti hesabı için Active Directory hesap ayrıntılarını sağlamanız istenir.

Komut, yükleme günlüğünün bulunduğu yükleme ilerleme durumunu ve Microsoft Purview Bilgi Koruma Tarayıcısı adlı yeni Windows Uygulaması olay günlüğünün oluşturulmasını görüntüler

Çıktının sonunda, İşlem yapılan yükleme tamamlandı ifadesini görürsünüz.

Örnek 2: SQL Server varsayılan örneğini kullanarak Microsoft Purview Bilgi Koruması Scanner hizmetini yükleme

PS C:\> Install-Scanner -SqlServerInstance SQLSERVER1 -Cluster EU

Bu komut, SQLSERVER1 adlı sunucuda çalışan SQL Server varsayılan örneğini kullanarak Microsoft Purview Bilgi Koruması tarayıcı hizmetini yükler.

Önceki örnekte olduğu gibi, kimlik bilgileri istenir ve ardından komut, yükleme günlüğünün bulunduğu ilerleme durumunu ve yeni Windows Uygulaması olay günlüğünün oluşturulmasını görüntüler.

Örnek 3: SQL Server Express kullanarak Microsoft Purview Bilgi Koruması tarayıcı hizmetini yükleme

PS C:\> Install-Scanner -SqlServerInstance SQLSERVER1\SQLEXPRESS -Cluster EU

Bu komut, SQLSERVER1 adlı sunucuda çalışan SQL Server Express kullanarak Microsoft Purview Bilgi Koruması Tarayıcısı hizmetini yükler.

Önceki örneklerde olduğu gibi, kimlik bilgileri istenir ve ardından komut, yükleme günlüğünün bulunduğu ilerleme durumunu ve yeni Windows Uygulaması olay günlüğünün oluşturulmasını görüntüler.

Örnek 4: Tarayıcıyı kur ve kurulum zamanında küme düzeyinde bir özelliği etkinleştir (önizleme)

PS C:\> Install-Scanner -SqlServerInstance SQLSERVER1 -Cluster EU -FeatureSettings @{CustomReporting=$true}

Bu komut, Microsoft Purview Bilgi Koruması Tarayıcı servisini yükler ve tüm tarayıcı kümesi için Özel Raporlama özelliğini etkinleştirir. Tüm düğümler bir sonraki tarama döngüsünde değişimi algılar.

Daha fazla bilgi için Tarayıcı özellik kontrolü (önizleme) bölümüne bakınız.

Parametreler

-Cluster

Aşağıdaki sözdizimini kullanarak, tarayıcı yapılandırması için tarayıcı veritabanının adını belirtir: AIPScannerUL_<cluster_name>.

Tarayıcı yüklendiğinde adlandırdığınız veritabanı yoksa, bu komut onu oluşturur.

Bu parametrenin veya Profile parametresinin kullanılması zorunludur. Profile parametresi yerine bu parametreyi kullanmanızı öneririz.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Profil

Parametre kümeleri

(All)
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

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Parametre özellikleri

Tür:SwitchParameter
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Cf

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

-FeatureSettings

(Kamu Önizleme) Kurulumun bir parçası olarak küme düzeyinde Microsoft Purview Bilgi Koruması tarayıcı özelliklerini yapılandırır. Bu ayar, bir sonraki tarama döngüsünde tarayıcı kümesindeki her düğüm için geçerlidir. Servisin yeniden başlatılması gerekmez.

-FeatureSettings özellik adı ve ayar çiftlerinden oluşan bir PowerShell hashtable'ı kabul eder. Her anahtar özellik adıdır (örneğin, CustomReporting); her özellik için desteklenen değerler Tarayıcı özellik kontrolü (önizleme) üzerinde belgelenir.

Örneğin: Install-Scanner -SqlServerInstance SQLSERVER1 -Cluster Europe -FeatureSettings @{CustomReporting=$true}.

Hem özellik adı hem de değeri, kurulum çalışması yapılmadan önce doğrulanır. Herhangi bir giriş geçersiz olursa, cmdlet sonlanır ve hiçbir durum değiştirilmez.

Arka plan için, bu istemci sürümü tarafından desteklenen özelliklerin listesi ve örnekler için Tarayıcı özellik kontrolü (önizleme) bölümüne bakınız.

Parametre özellikleri

Tür:Hashtable
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

-Profile

Tarayıcı yapılandırması için tarayıcı veritabanının adını belirtir.

Bu parametrenin veya Cluster parametresinin kullanılması zorunludur. Bu parametre yerine Cluster parametresini kullanmanızı öneririz.

Tarayıcının veritabanı adı AIPScannerUL_<profile_name'dir>.

Tarayıcı yüklendiğinde adlandırdığınız veritabanı yoksa, bu komut onu oluşturur.

Parametre özellikleri

Tür:String
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

-ServiceUserCredentials

Microsoft Purview Bilgi Koruması tarayıcısını çalıştırmak için kullanılan hesap kimlik bilgilerini belirtir.

  • Kullanılan kimlik bilgileri bir Active Directory hesabı olmalıdır.

  • Aşağıdaki sözdizimini kullanarak bu parametrenin değerini ayarlayın: Domain\Username.

    Örneğin: contoso\scanneraccount

  • Bu parametreyi belirtmezseniz, kullanıcı adı ve parola girmeniz istenir.

Daha fazla bilgi için Microsoft Purview Bilgi Koruması tarayıcısı için önkoşullar'a bakın.

Tavsiye

Get-Credential cmdlet'ini kullanarak bir PSCredential nesnesi kullanın. Bu durumda, yalnızca parola girmeniz istenir.

Daha fazla bilgi için Get-Help Get-Cmdletyazın.

Parametre özellikleri

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

Parametre kümeleri

(All)
Position:0
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

-ShareAdminUserAccount

Şirket içi ağda, dosya paylaşımı ve NTFS izinlerinin tam listesini almak için kullanılan güçlü bir hesabın kimlik bilgilerini belirtir.

  • Kullanılan kimlik bilgileri, ağ paylaşımlarınızda Yönetici/FC haklarına sahip bir Active Directory hesabı olmalıdır. Bu genellikle bir Sunucu Yöneticisi veya Etki Alanı Yöneticisi olacaktır.

  • Aşağıdaki sözdizimini kullanarak bu parametrenin değerini ayarlayın: Domain\Username

    Örneğin: contoso\admin

  • Bu parametreyi belirtmezseniz, hem kullanıcı adı hem de parola girmeniz istenir.

Tavsiye

Get-Credential cmdlet'ini kullanarak bir PSCredential nesnesi kullanın. Bu durumda, yalnızca parola girmeniz istenir.

Daha fazla bilgi için Get-Help Get-Cmdletyazın.

Parametre özellikleri

Tür:PSCredential
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

-SqlServerInstance

Microsoft Purview Bilgi Koruması tarayıcısı için bir veritabanı oluşturulacak SQL Server örneğini belirtir.

SQL Server gereksinimleri hakkında daha fazla bilgi için Microsoft Purview Bilgi Koruması tarayıcısı için önkoşullar'a bakın.

  • Varsayılan örnek için sunucu adını belirtin. Örneğin: SQLSERVER1.

  • Adlandırılmış bir örnek için, sunucu adını ve örnek adını belirtin. Örneğin: SQLSERVER1\MIPSCANNER.

  • SQL Server Express için sunucu adını ve SQLEXPRESS'i belirtin. Örneğin: SQLSERVER1\SQLEXPRESS.

Parametre özellikleri

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

Parametre kümeleri

(All)
Position:2
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

-StandardDomainsUserAccount

Şirket içi ağdaki zayıf bir hesabın kimlik bilgilerini belirtir, ağdaki zayıf kullanıcıların erişimini denetlemek ve bulunan ağ paylaşımlarını kullanıma sunmak için kullanılır.

  • Kullanılan kimlik bilgileri bir Active Directory hesabı ve yalnızca Domain Users grubunun bir kullanıcısı olmalıdır.

  • Aşağıdaki sözdizimini kullanarak bu parametrenin değerini ayarlayın: Domain\Username

    Örneğin: contoso\stduser

  • Bu parametreyi belirtmezseniz, hem kullanıcı adı hem de parola girmeniz istenir.

Tavsiye

Get-Credential cmdlet'ini kullanarak bir PSCredential nesnesi kullanın. Bu durumda, yalnızca parola girmeniz istenir.

Daha fazla bilgi için Get-Help Get-Cmdletyazın.

Parametre özellikleri

Tür:PSCredential
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
Diğer adlar:Wi

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

Girişler

None

Çıkışlar

System.Object