Partilhar via

New-FileCatalog

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

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

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 foram feitas alterações nas pastas desde o momento da criação do catálogo.

As versões de catálogo 1 e 2 são suportadas. 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
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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 inseguro SHA-1. Versão 2.0 usa o algoritmo seguro SHA-256.

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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[]
Position:1
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

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

Saídas

FileInfo

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

Notas

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