Arquivo Morto
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
CreatedDate
o recurso, o recurso verifica se a propriedade CreationTime de cada arquivo expandido corresponde à propriedade CreationTime desse arquivo no arquivo. - Com
SHA-1
,SHA-256
ouSHA-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
- Expandir um arquivo sem validação
- Expandir um arquivo morto em uma conta diferente sem validação
- Expandir um arquivo morto com validação padrão e substituir, se necessário
- Expandir um arquivo morto com validação SHA-256 e substituir, se necessário
- Remover um arquivo morto sem validação
- Remover um arquivo morto com validação SHA-256
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de