DSC Arşiv Kaynağı

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

Windows PowerShell Desired State Configuration'deki (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ı 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

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

Özellik	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	İ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ğrulama 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.
Force	Bazı dosya işlemleri (örneğin, bir dosyanın üzerine yazma veya boş olmayan bir dizini silme) hataya neden olur. Force özelliğinin kullanılması bu tür hataları geçersiz kılar. Varsayılan değer False'tur.
Doğrulama	Arşivin imzayla eşleşip eşleşmediğini belirlemek için Sağlama Toplamı özelliğini kullanır. Doğrulama olmadan Sağlama Toplamı belirtirseniz yapılandırma başarısız olur. Sağlama Toplamı Olmadan Doğrula'yı belirtirseniz, sha-256sağlama toplamı varsayılan olarak kullanılı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	Arşivin içeriğinin Hedef'te var olup olmadığının denetlenip denetlenmeyeceğini belirler. İçeriğin mevcut olduğundan emin olmak için bu özelliği Present olarak ayarlayın. Mevcut olmadığından emin olmak için Bunu Yok 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

Aşağıdaki örnekte, adlı Test.zip 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"
}