Compartilhar via

New-FileCatalog

  • Referência
Módulo:
Microsoft.PowerShell.Security

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

Sintaxe

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

Description

Este cmdlet só está disponível na plataforma Windows.

New-FileCatalog cria um arquivo de catálogo do Windows para um conjunto de pastas e arquivos. Este 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 os usuários possam validar se alguma alteração foi feita nas pastas desde a hora de criação do catálogo.

Há suporte para as versões de catálogo 1 e 2. A versão 1 usa o algoritmo de hash SHA1 (preterido) 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 chamado 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 os valores possíveis para especificar a versão do catálogo. 1.0 deve ser evitada sempre que possível porque usa o algoritmo de hash SHA-1 inseguro. O 2.0 de versão usa o algoritmo SHA-256 seguro.

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

-Confirm

Solicita a 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 uma 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 nome de arquivo de catálogo para este cmdlet.

Saídas

FileInfo

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

Observações

Esse cmdlet só está disponível em plataformas Windows.