DSC Arşiv Kaynağı

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

Windows PowerShell İstenen Durum Yapılandırması'ndaki (DSC) Arşiv kaynağı, arşiv (.zip) dosyalarını belirli bir yolda açmak 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ını içerir. PSDscResources modülü PowerShell Galerisi'nden edinilebilir.

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

Sözdizimi

Archive [string] #ResourceName
{
    Destination = [string]
    Path = [string]
    [ Checksum = [string] { CreatedDate | ModifiedDate | SHA-1 | SHA-256 | SHA-512 } ]
    [ Credential = [PSCredential] ]
    [ Force = [bool] ]
    [ Validate = [bool] ]
    [ Ensure = [string] { Absent | Present } ]
    [ DependsOn = [string[]] ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Özellikler

Mülk	Açıklama
Hedef	Arşiv içeriğinin ayıklandığından emin olmak istediğiniz konumu belirtir.
Yol	Arşiv dosyasının kaynak yolunu belirtir.
Sağlama toplamı	İki dosya aynı olup olmadığını belirlerken kullanılacak türü tanımlar. Sağlama Toplamı belirtilmezse, karşılaştırma için yalnızca dosya veya dizin adı kullanılır. Geçerli değerler şunlardır: SHA-1, SHA-256, SHA-512, createdDate, modifiedDate. Doğrula olmadan sağlama toplamı belirtirseniz yapılandırma başarısız olur.
Kimlik bilgisi	Gerekirse, belirtilen arşiv yoluna ve hedefine erişme izinlerine sahip bir kullanıcı hesabının kimlik bilgisi.
Kuvvet	Bazı dosya işlemleri (örneğin, bir dosyanın üzerine yazma veya boş olmayan bir dizini silme) hataya neden olur. Zorla özelliğinin kullanılması bu tür hataları geçersiz kılar. Varsayılan değer Falsedeğeridir.
Doğrulamak	Arşivin imzayla eşleşip eşleşmediğini belirlemek için Sağlama Toplamı özelliğini kullanır. Doğrula olmadan sağlama toplamı belirtirseniz yapılandırma başarısız olur. sağlama toplamıolmadan doğrula belirtirseniz, varsayılan olarak SHA-256Sağlama Toplamı kullanılır.

Ortak özellikler

Mülk	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 betiği bloğunun kimliği ResourceName ve türü ResourceType ise, bu özelliğin kullanıldığı söz dizimi DependsOn = "[ResourceType]ResourceName".
Sağlamak	Arşiv içeriğinin Hedef'nde bulunup bulunmadığının denetlenip denetlenmeyeceğini belirler. İçeriğin mevcut olduğundan emin olmak için bu özelliği Sun olarak ayarlayın. Mevcut olmadığından emin olmak için Yok olarak ayarlayın. Varsayılan değer Sun'dır.
PsDscRunAsCredential	Kaynağın tamamını farklı çalıştırmak için kimlik bilgilerini 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. Kimlik Bilgilerini DSC Kaynaklarıyla Kullanma.

Örnek

Aşağıdaki örnekte, Test.zip adlı bir arşiv dosyasının içeriğinin mevcut olduğundan ve kullanılarak ve yetkilendirilerek belirli bir hedefte ayıklandığından emin olmak için Arşiv kaynağının nasıl kullanılacağı gösterilmektedir.

Archive ArchiveExample {
    Ensure = "Present"
    Path = "C:\Users\Public\Documents\Test.zip"
    Destination = "C:\Users\Public\Documents\ExtractionPath"
}