DSC arşiv kaynağı

  • Makale
  • Okumak için 2 dakika

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

Windows PowerShell Istenen durum yapılandırması 'ndaki (DSC) arşiv kaynağı, belirli bir yoldaki Arşiv (. zip) dosyalarının paketini açmak 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

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ıklanmasını sağlamak istediğiniz konumu belirtir.
Yol Arşiv dosyasının kaynak yolunu belirtir.
Sağlama İki dosyanın aynı olup olmadığını belirlerken kullanılacak türü tanımlar. Sağlama toplamı belirtilmemişse, 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 & lt . Doğrulaması 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 bilgileri.
Force Belirli dosya işlemleri (bir dosyanın üzerine yazılması veya boş olmayan bir dizini silmek gibi), bir hatayla sonuçlanır. Zorlama özelliğinin kullanılması bu hataları geçersiz kılar. Varsayılan değer false 'dur.
Doğrulama Arşivin imzayla eşleşip eşleşmediğini anlamak için sağlama toplamı özelliğini kullanır. Doğrulaması olmadan sağlama toplamı belirtirseniz, yapılandırma başarısız olur. Sağlama toplamı olmadan doğrulama belirtirseniz, varsayılan olarak bir SHA-256 sağlama toplamı kullanılı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 Arşiv içeriğinin hedefte olup olmadığını denetleyip denetmeyeceğini belirler. İçeriğin mevcut olduğundan emin olmak için bu özelliği mevcut olarak ayarlayın. Bulunmadığından emin olmak için bunu yok 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

Aşağıdaki örnek Arşiv kaynağını kullanarak, bir arşiv dosyası içeriğinin Test.zip var olduğunu ve belirli bir hedefte, ve yetkilendirildiğinde ayıklanmasını sağlamak için nasıl kullanılacağını gösterir.

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