DSC paketi kaynağı

  • Makale
  • Okumak için 2 dakika

Uygulama hedefi: Windows PowerShell 4,0, Windows PowerShell 5. x

Windows PowerShell Istenen durum yapılandırması (DSC) içindeki paket kaynağı, hedef bir düğümdeki 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 belgesi, PowerShell 'e dahil edilen sürümü kapsar. Psdscresources modülü, Microsoft tarafından resmi olarak desteklenen yeni ve güncelleştirilmiş bir içerir. Psdscresources modülü PowerShell Galerisi kullanılabilir.

daha fazla bilgi ve güncelleştirilmiş belgeler için GitHub deposundaki benioku dosyasına 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 durumu sağlamak istediğiniz paketin adını gösterir.
Yol Paketin bulunduğu yolu gösterir.
ProductId Paketi benzersiz bir şekilde tanımlayan ürün KIMLIĞINI gösterir.
Arguments Pakete tam olarak verilen şekilde geçirilecek bağımsız değişkenlerin bir dizesini listeler.
Kimlik Bilgisi Uzak bir kaynaktaki pakete erişim sağlar. Bu özellik paketi yüklemek için kullanılmaz. Paket her zaman yerel sisteme yüklenir.
LogPath Sağlayıcının paketi yüklemek veya kaldırmak için bir 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 belirtilen 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ıldıktan ö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 betiği bloğunun KIMLIĞI ResourceName ise ve türü ResourceType ise, bu özelliği kullanmak için sözdizimi olur DependsOn = "[ResourceType]ResourceName" .
Belirttiğinden Paketin yüklenip yüklenmediğini gösterir. Paketin yüklü olmadığından emin olmak için bu özelliği yok olarak ayarlayın (veya yüklüyse paketi kaldırın). Paketin yüklü olduğundan emin olmak için bunu mevcut olarak ayarlayın. Varsayılan değer vardır .
PsDscRunAsCredential Tüm kaynağı olarak çalıştırmaya yönelik kimlik bilgisini ayarlar.

Not

Diğer kimlik bilgileri bağlamında herhangi bir DSC kaynağını çalıştırmaya izin vermek için, WMF 5,0 'e Psdscrunascredential ortak özelliği eklenmiştir. Daha fazla bilgi için bkz. DSC kaynaklarıyla kimlik bilgilerini kullanma.

Örnek

Bu örnekte, belirtilen yolda bulunan ve belirtilen ürün KIMLIĞINE sahip olan. msi yükleyicisi çalıştırılır.

Configuration PackageTest
{
    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"
    }
}