New-FileCatalog

New-FileCatalog cria um arquivo de catálogo de hashes de arquivo que pode ser usado para validar a autenticidade de um arquivo.

Syntax

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. Em seguida, 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 1 e 2 do catálogo. A versão 1 usa o algoritmo de hash SHA1 (preterido) para criar hashes de arquivo e a versão 2 usa SHA256. Não há suporte para a versão 2 do catálogo no Windows Server 2008 R2 ou no Windows 7. Você deve usar a versão 2 do catálogo no Windows 8, no Windows Server 2012 e nos sistemas operacionais posteriores.

Exemplos

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

New-FileCatalog -Path $PSHOME\Modules\Microsoft.PowerShell.Utility -CatalogFilePath \temp\Microsoft.PowerShell.Utility.cat -CatalogVersion 2.0

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

Parâmetros

-CatalogFilePath

Um caminho para um arquivo ou pasta em que o arquivo de catálogo (.cat) deve ser colocado. Se um caminho de pasta for especificado, o nome catalog.cat de arquivo padrão será usado.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CatalogVersion

1.0 Aceita ou 2.0 os valores possíveis para especificar a versão do catálogo. 1.0 deve ser usado evitado sempre que possível, pois usa o algoritmo de hash SHA-1 inseguro, enquanto 2.0 usa o algoritmo SHA-256 seguro No entanto, 1.0 é o único algoritmo com suporte no Windows 7 e no Server 2008R2.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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, todos os arquivos na pasta também serão incluídos.

Type:String[]
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

O pipeline usa uma cadeia de caracteres usada como nome de arquivo de catálogo.

Saídas

FileInfo

Observações

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