Compartilhar via


New-FileCatalog

Cria um arquivo de catálogo do Windows contendo hashes criptográficos para arquivos e pastas nos caminhos especificados.

Sintaxe

New-FileCatalog
   [-CatalogVersion <Int32>]
   [-CatalogFilePath] <String>
   [[-Path] <String[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-FileCatalog cria um arquivo de catálogo do Windows para um conjunto de pastas e arquivos. Esse arquivo de catálogo contém hashes para todos os arquivos nos caminhos fornecidos. Os usuários podem distribuir o catálogo com seus arquivos para que possam validar se alguma alteração foi feita nas pastas desde o momento da criação do catálogo.

Há suporte para as versões 1 e 2 do catálogo. A versão 1 usa o algoritmo de hash SHA1 (obsoleto) para criar hashes de arquivo e a versão 2 usa SHA256.

Exemplos

Exemplo 1: Criar um catálogo de arquivos para 'Microsoft.PowerShell.Utility'

$newFileCatalogSplat = @{
    Path = "$PSHOME\Modules\Microsoft.PowerShell.Utility"
    CatalogFilePath = '\temp\Microsoft.PowerShell.Utility.cat'
    CatalogVersion = 2.0
}
New-FileCatalog @newFileCatalogSplat

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----         11/2/2018 11:58 AM            950 Microsoft.PowerShell.Utility.cat

Parâmetros

-CatalogFilePath

O local e o nome do arquivo de catálogo (.cat) que você está criando. Se você especificar apenas um caminho de pasta, o comando criará um arquivo nomeado catalog.cat nesse local.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-CatalogVersion

Aceita 1.0 ou 2.0 como valores possíveis para especificar a versão do catálogo. 1.0 deve ser evitado sempre que possível porque usa o algoritmo de hash SHA-1 inseguro. A versão 2.0 usa o algoritmo seguro SHA-256.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Path

Aceita um caminho ou matriz de caminhos para arquivos ou pastas que devem ser incluídos no arquivo de catálogo. Se uma pasta for especificada, o comando incluirá todos os arquivos na pasta.

Tipo:String[]
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

Você pode canalizar uma cadeia de caracteres usada como o nome do arquivo de catálogo para esse cmdlet.

Saídas

FileInfo

Esse cmdlet retorna um objeto FileInfo que representa o catálogo criado.