DSC 封存資源

適用於：Windows PowerShell 4.0、Windows PowerShell 5.x

Windows PowerShell 預期狀態設定 （DSC） 中的封存資源會提供一個機制，以在特定路徑解除封存 （.zip） 檔案。

注意

此 DSC 資源的本文件涵蓋 PowerShell 7.2 版之前隨附的版本。 PSDscResources 模組包含Microsoft正式支援的全新和更新 DSC 資源。 您可以從 PowerShell 資源庫取得 PSDscResources 模組。

如需詳細資訊和更新的檔，請參閱 PSDscResources 參考檔。

語法

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] ]
}

性能

財產	描述
目的地	指定您想要確保擷取封存內容的位置。
路徑	指定封存盤案的來源路徑。
校驗和	定義判斷兩個檔案是否相同時要使用的類型。 如果未指定 總和檢查碼，則只會使用檔案或目錄名稱進行比較。 有效值包括：SHA-1、SHA-256、SHA-512、createdDate、modifiedDate。 如果您在未 驗證的情況下指定 總和檢查碼，則設定將會失敗。
憑據	具有存取指定封存路徑和目的地之許可權之用戶帳戶的認證，如有需要。
力	某些檔案作業（例如覆寫檔案或刪除不是空的目錄），將會導致錯誤。 使用 Force 屬性會覆寫這類錯誤。 預設值 False。
驗證	使用 Checksum 屬性來判斷封存是否符合簽章。 如果您在未 驗證的情況下指定 總和檢查碼，則設定將會失敗。 如果您指定 驗證 而不 總和檢查碼，預設會使用 SHA-256總和檢查碼。

通用屬性

財產	描述
DependsOn	表示必須執行另一個資源的設定，才能設定此資源。 例如，如果您想要先執行之資源組態腳本區塊的標識碼是 ResourceName，且其類型為 ResourceType，則使用此屬性的語法 DependsOn = "[ResourceType]ResourceName"。
確保	判斷是否要檢查封存的內容是否存在於 Destination。 將此屬性設定為 Present，以確保內容存在。 將它設定為 Absent，以確保它們不存在。 預設值為 Present。
PsDscRunAsCredential	將執行整個資源的認證設定為 。

注意

PsDscRunAsCredential common 屬性已新增至 WMF 5.0 中，以允許在其他認證的內容中執行任何 DSC 資源。 如需詳細資訊，請參閱 搭配 DSC 資源使用認證。

例

下列範例示範如何使用封存資源來確保名為 Test.zip 的封存盤案內容存在，並使用 和 授權在指定的目的地擷取。

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