Arquivo Morto

  • Artigo

Sinopse

Expanda ou remova o conteúdo de um arquivo de arquivamento (.zip).

Sintaxe

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

Descrição

O Archive recurso permite que você gerencie idempotentemente o conteúdo expandido de um arquivo de arquivamento (.zip). Ele pode garantir que o conteúdo expandido de um arquivo esteja atualizado ou removido de um sistema.

Requisitos

  • O assembly do tipo System.IO.Compression deve estar disponível no computador.
  • O assembly do tipo System.IO.Compression.FileSystem deve estar disponível no computador.

Propriedades da chave

Destino

Especifique o caminho para a pasta da qual o conteúdo expandido deve ser gravado ou removido.

Type: System.String

Caminho

Especifique o caminho para o arquivo de arquivo de arquivos.

Type: System.String

Propriedades opcionais

Checksum (soma de verificação)

Especifique o método de soma de verificação a ser usado ao validar o conteúdo expandido no arquivo morto. Se você especificar um valor para Soma de Verificação e Validação como $false, o recurso gerará uma exceção de argumento inválida.

Se você especificar Validar como $true, o padrão para Checksum será ModifiedDate.

Observação

Usar Checksum ou Validate implica o outro. Embora você possa especificar Validar sem Soma de Verificação, é melhor especificar ambos juntos.

O método especificado determina como o recurso valida o conteúdo expandido em relação ao arquivo:

  • Com ModifiedDate, o recurso verifica se a propriedade LastWriteTime de cada arquivo expandido corresponde à propriedade LastWriteTime desse arquivo no arquivo.
  • Com CreatedDateo recurso, o recurso verifica se a propriedade CreationTime de cada arquivo expandido corresponde à propriedade CreationTime desse arquivo no arquivo.
  • Com SHA-1, SHA-256ou SHA-512, o recurso usa o método SHA especificado para verificar o hash de cada arquivo expandido em relação ao hash desse arquivo no arquivo arquivado.
Type: System.String
Accepted Values:
  - ModifiedDate
  - CreatedDate
  - SHA-1
  - SHA-256
  - SHA-512
Default Value: ModifiedDate

Credencial

Especifique a credencial de uma conta de usuário com permissões para acessar o Caminho e o Destino especificados , se necessário.

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

Ensure

Especifique se o conteúdo expandido do arquivo de arquivo de arquivo deve existir. Para expandir o arquivo morto, especifique essa propriedade como Present. Para remover o conteúdo expandido do arquivo morto, especifique essa propriedade como Absent. O valor padrão é Present.

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

Force

Especifique se deseja substituir o conteúdo existente no Destino. Quando Force é $false, o recurso erros se um item no destino precisa ser substituído. O valor padrão é $false.

Type: System.Boolean
Default Value: false

Validar

Especifique se o conteúdo expandido deve ser verificado pelo método de soma de verificação especificado. O valor padrão é $false.

Quando Validar é $true e o arquivo no destino não corresponde ao arquivo no arquivo no arquivo:

  • Se Ensure for Present e Force for $false, os erros de recurso com uma mensagem informando que o arquivo no destino não pode ser substituído.
  • Se Ensure for Present e Force for $true, o recurso substituirá o arquivo.
  • Se Ensure for Absent, o recurso não removerá o arquivo.
Type: System.Boolean
Default Value: false

Exemplos