Arkiv

Artikel
05/05/2023

Synopsis

Expandera eller ta bort innehållet i en arkivfil (.zip).

Syntax

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

Description

Med resursen Archive kan du idempotent hantera det utökade innehållet i en arkivfil (.zip). Det kan säkerställa att ett arkivs utökade innehåll är uppdaterat eller borttaget från ett system.

Krav

Sammansättningen Av typen System.IO.Compression måste vara tillgänglig på datorn.
Sammansättningen System.IO.Compression.FileSystem måste vara tillgänglig på datorn.

Nyckelegenskaper

Mål

Ange sökvägen till mappen som det expanderade innehållet ska skrivas till eller tas bort från.

Type: System.String

Sökväg

Ange sökvägen till arkivfilen.

Type: System.String

Valfria egenskaper

Kontrollsumma

Ange den kontrollsummametod som ska användas när expanderat innehåll verifieras mot arkivet. Om du anger ett värde för Checksum och Validate som $falsegenererar resursen ett ogiltigt argumentfel.

Om du anger Verifiera som $trueär ModifiedDatestandardvärdet för Checksum .

Anteckning

Att använda antingen Checksum eller Validate innebär det andra. Även om du kan ange Verifiera utan Kontrollsumma är det bästa praxis att ange båda tillsammans.

Den angivna metoden avgör hur resursen validerar det expanderade innehållet mot arkivet:

Med ModifiedDatekontrollerar resursen att egenskapen LastWriteTime för varje expanderad fil matchar egenskapen LastWriteTime för filen i arkivet.
Med CreatedDatekontrollerar resursen att egenskapen CreationTime för varje expanderad fil matchar egenskapen CreationTime för filen i arkivet.
Med SHA-1, SHA-256eller SHA-512använder resursen den angivna SHA-metoden för att verifiera hashen för varje expanderad fil mot hashen för filen i arkivet.

Type: System.String
Accepted Values:
  - ModifiedDate
  - CreatedDate
  - SHA-1
  - SHA-256
  - SHA-512
Default Value: ModifiedDate

Autentiseringsuppgift

Ange autentiseringsuppgifterna för ett användarkonto med behörighet att komma åt den angivna sökvägen och målet om det behövs.

Type: System.Management.Automation.PSCredential
Default Value: None

Säkerställa

Ange om det utökade innehållet i arkivfilen ska finnas. Om du vill expandera arkivet anger du den här egenskapen som Present. Om du vill ta bort det expanderade innehållet i arkivet anger du den här egenskapen som Absent. Standardvärdet är Present.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

Force

Ange om befintligt innehåll ska skrivas över i målet. När Force är $false, felar resursen om ett objekt på målet måste skrivas över. Standardvärdet är $false.

Type: System.Boolean
Default Value: false

Verifiera

Ange om expanderat innehåll ska verifieras med den angivna kontrollsummametoden. Standardvärdet är $false.

När Validate är $true och filen på målet inte matchar filen i arkivet:

Om Se till är Present och Framtvinga är $falsekan resursfelen med ett meddelande om att filen på målet inte kan skrivas över.
Om Se till är Present och Force är $trueskriver resursen över filen.
Om Kontrollera är Absenttar resursen inte bort filen.

Type: System.Boolean
Default Value: false

Share via