Compartir a través de

Archivo

  • Artículo

Sinopsis

Expanda o quite el contenido de un archivo de archivo (.zip).

Sintaxis

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

Descripción

El Archive recurso permite administrar de forma idempotente el contenido expandido de un archivo (.zip). Puede asegurarse de que el contenido expandido de un archivo esté actualizado o quitado de un sistema.

Requisitos

  • El ensamblado de tipo System.IO.Compression debe estar disponible en el equipo.
  • El ensamblado de tipo System.IO.Compression.FileSystem debe estar disponible en el equipo.

Propiedades de la clave

Destination

Especifique la ruta de acceso a la carpeta en la que se debe escribir o quitar el contenido expandido.

Type: System.String

Ruta de acceso

Especifique la ruta de acceso al archivo de archivo.

Type: System.String

Propiedades opcionales

Suma de comprobación

Especifique el método de suma de comprobación que se usará al validar el contenido expandido en el archivo. Si especifica un valor para Checksum y Validate como $false, el recurso produce una excepción de argumento no válida.

Si especifica Validate como $true, el valor predeterminado de Checksum es ModifiedDate.

Nota

El uso de Checksum o Validate implica el otro. Aunque puede especificar Validate sin Checksum, se recomienda especificar ambos juntos.

El método especificado determina cómo el recurso valida el contenido expandido en el archivo:

  • Con ModifiedDate, el recurso comprueba que la propiedad LastWriteTime de cada archivo expandido coincide con la propiedad LastWriteTime de ese archivo en el archivo.
  • Con CreatedDate, el recurso comprueba que la propiedad CreationTime de cada archivo expandido coincide con la propiedad CreationTime de ese archivo en el archivo.
  • Con SHA-1, SHA-256o SHA-512, el recurso usa el método SHA especificado para comprobar el hash de cada archivo expandido con el hash de ese archivo en el archivo.
Type: System.String
Accepted Values:
  - ModifiedDate
  - CreatedDate
  - SHA-1
  - SHA-256
  - SHA-512
Default Value: ModifiedDate

Credential:

Especifique la credencial de una cuenta de usuario con permisos para acceder a la rutade acceso y destino especificadas si es necesario.

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

Ensure

Especifique si debe existir el contenido expandido del archivo de archivo. Para expandir el archivo, especifique esta propiedad como Present. Para quitar el contenido expandido del archivo, especifique esta propiedad como Absent. El valor predeterminado es Present.

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

Force

Especifique si se va a sobrescribir el contenido existente en El destino. Cuando Force es $false, el recurso genera errores si es necesario sobrescribir un elemento en el destino. El valor predeterminado es $false.

Type: System.Boolean
Default Value: false

Validación

Especifique si se debe comprobar el contenido expandido por el método de suma de comprobación especificado. El valor predeterminado es $false.

Cuando Validate es $true y el archivo en el destino no coincide con el archivo en el archivo:

  • Si Ensure es Present y Force es $false, los errores de recursos con un mensaje que indica que no se puede sobrescribir el archivo en el destino.
  • Si Ensure es Present y Force es $true, el recurso sobrescribe el archivo.
  • Si Ensure es Absent, el recurso no quita el archivo.
Type: System.Boolean
Default Value: false

Ejemplos