Risorsa archivio DSC

Si applica a: Windows PowerShell 4.0, Windows PowerShell 5.x

La risorsa Archivio in Windows PowerShell DSC (Desired State Configuration) fornisce un meccanismo per decomprimere i file di archiviazione (.zip) in un percorso specifico.

Nota

Questa documentazione di questa risorsa DSC illustra la versione inclusa in PowerShell prima della versione 7.2. Il modulo PSDscResources contiene risorse DSC nuove e aggiornate supportate ufficialmente da Microsoft. Il modulo PSDscResources è disponibile in PowerShell Gallery.

Per altre informazioni e documentazione aggiornata, vedere la documentazione di riferimento PSDscResources.

Sintassi

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

Proprietà

Proprietà	Descrizione
Destinazione	Specifica il percorso in cui si desidera assicurarsi che il contenuto dell'archivio venga estratto.
Sentiero	Specifica il percorso di origine del file di archivio.
Checksum	Definisce il tipo da utilizzare per determinare se due file sono uguali. Se checksum non viene specificato, per il confronto viene usato solo il nome del file o della directory. I valori validi includono: SHA-1, SHA-256, SHA-512, createdDate, modifiedDate. Se si specifica checksum senza Convalida, la configurazione avrà esito negativo.
Credenziale	Credenziali di un account utente con autorizzazioni per accedere al percorso di archiviazione e alla destinazione specificati, se necessario.
Forza	Alcune operazioni sui file, ad esempio la sovrascrittura di un file o l'eliminazione di una directory non vuota, genereranno un errore. L'utilizzo della proprietà force esegue l'override di tali errori. Il valore predefinito è False.
Convalidare	Usa la proprietà checksum per determinare se l'archivio corrisponde alla firma. Se si specifica checksum senza Convalida, la configurazione avrà esito negativo. Se si specifica Validate without Check sum, per impostazione predefinita viene utilizzata unachecksum SHA-256.

Proprietà comuni

Proprietà	Descrizione
DependsOn	Indica che la configurazione di un'altra risorsa deve essere eseguita prima della configurazione di questa risorsa. Ad esempio, se l'ID del blocco di script di configurazione della risorsa che si vuole eseguire per primo è ResourceName e il relativo tipo è ResourceType, la sintassi per l'uso di questa proprietà è DependsOn = "[ResourceType]ResourceName".
Assicurare	Determina se verificare se il contenuto dell'archivio esiste nel Destinazione. Impostare questa proprietà su Present per assicurarsi che il contenuto esista. Impostarlo su absent per assicurarsi che non esistano. Il valore predefinito è Present.
PsDscRunAsCredential	Imposta le credenziali per l'esecuzione dell'intera risorsa come .

Nota

La PsDscRunAsCredential proprietà comune è stata aggiunta in WMF 5.0 per consentire l'esecuzione di qualsiasi risorsa DSC nel contesto di altre credenziali. Per altre informazioni, vedere Usare credenziali con risorse DSC.

Esempio

Nell'esempio seguente viene illustrato come usare la risorsa Archive per assicurarsi che il contenuto di un file di archivio denominato Test.zip esista e venga estratto in una determinata destinazione usando e autorizzato.

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