Arkiv
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 $false
genererar resursen ett ogiltigt argumentfel.
Om du anger Verifiera som $true
är ModifiedDate
standardvä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
ModifiedDate
kontrollerar resursen att egenskapen LastWriteTime för varje expanderad fil matchar egenskapen LastWriteTime för filen i arkivet. - Med
CreatedDate
kontrollerar resursen att egenskapen CreationTime för varje expanderad fil matchar egenskapen CreationTime för filen i arkivet. - Med
SHA-1
,SHA-256
ellerSHA-512
anvä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$false
kan resursfelen med ett meddelande om att filen på målet inte kan skrivas över. - Om Se till är
Present
och Force är$true
skriver resursen över filen. - Om Kontrollera är
Absent
tar resursen inte bort filen.
Type: System.Boolean
Default Value: false
Exempel
- Expandera ett arkiv utan validering
- Expandera ett arkiv under ett annat konto utan validering
- Expandera ett arkiv med standardverifiering och skriv över om det behövs
- Expandera ett arkiv med SHA-256-validering och skriv över om det behövs
- Ta bort ett arkiv utan validering
- Ta bort ett arkiv med SHA-256-validering
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för