DSC Paket Kaynağı

Şunlar için geçerlidir: Windows PowerShell 4.0, Windows PowerShell 5.x

Windows PowerShell Desired State Configuration(DSC) içindeki Paket kaynağı, hedef düğüme Windows Installer ve setup.exe paketleri gibi paketleri yüklemek veya kaldırmak için bir mekanizma sağlar.

Not

Bu DSC kaynağının bu belgeleri, PowerShell'in 7.2 sürümünden önceki sürümünü kapsar. PSDscResources modülü, Microsoft tarafından resmi olarak desteklenen yeni ve güncelleştirilmiş DSC Kaynakları içerir. PSDscResources modülü PowerShell Galerisi kullanılabilir.

Daha fazla bilgi ve güncelleştirilmiş belgeler için PSDscResources başvuru belgelerine bakın.

Syntax

Package [string] #ResourceName
{
    Name = [string]
    Path = [string]
    ProductId = [string]
    [ Arguments = [string] ]
    [ Credential = [PSCredential] ]
    [ LogPath = [string] ]
    [ ReturnCode = [UInt32[]] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string] { Absent | Present }  ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Özellikler

Özellik	Açıklama
Ad	Belirli bir durumdan emin olmak istediğiniz paketin adını gösterir.
Yol	Paketin bulunduğu yolu gösterir.
ProductId	Paketi benzersiz olarak tanımlayan ürün kimliğini gösterir.
Bağımsız değişkenler	Tam olarak sağlandığı gibi pakete geçirilecek bağımsız değişken dizesini listeler.
Kimlik Bilgisi	Uzak bir kaynakta pakete erişim sağlar. Bu özellik paketi yüklemek için kullanılmaz. Paket her zaman yerel sistemde yüklüdür.
Logpath	Sağlayıcının paketi yüklemek veya kaldırmak için günlük dosyasını kaydetmesini istediğiniz tam yolu gösterir.
ReturnCode	Beklenen dönüş kodunu gösterir. Gerçek dönüş kodu burada sağlanan beklenen değerle eşleşmiyorsa yapılandırma bir hata döndürür.

Ortak özellikler

Özellik	Açıklama
Dependson	Bu kaynak yapılandırılmadan önce başka bir kaynağın yapılandırmasının çalıştırılması gerektiğini gösterir. Örneğin, önce çalıştırmak istediğiniz kaynak yapılandırma betik bloğunun kimliği ResourceName ve türü ResourceType ise, bu özelliğin kullanıldığı söz dizimi şeklindedir DependsOn = "[ResourceType]ResourceName".
Sağlamak	Paketin yüklü olup olmadığını gösterir. Paketin yüklenmediğinden emin olmak için bu özelliği Yok olarak ayarlayın (veya yüklüyse paketi kaldırın). Paketin yüklendiğinden emin olmak için Bunu Sun olarak ayarlayın. Varsayılan değer Mevcut'tır.
PsDscRunAsCredential	Kaynağın tamamını çalıştırmak için kimlik bilgilerini olarak ayarlar.

Not

PsDscRunAsCredential common özelliği, diğer kimlik bilgileri bağlamında herhangi bir DSC kaynağının çalıştırılmasına izin vermek için WMF 5.0'a eklendi. Daha fazla bilgi için bkz. DSC Kaynaklarıyla Kimlik Bilgilerini Kullanma.

Örnek

Bu örnek, belirtilen yolda bulunan ve belirtilen ürün kimliğine sahip .msi yükleyicisini çalıştırır.

Configuration PackageTest
{
    Import-DscResource -ModuleName 'PSDesiredStateConfiguration'

    Package PackageExample
    {
        Ensure      = "Present"  # You can also set Ensure to "Absent"
        Path        = "$Env:SystemDrive\TestFolder\TestProject.msi"
        Name        = "TestPackage"
        ProductId   = "ACDDCDAF-80C6-41E6-A1B9-8ABD8A05027E"
    }
}