Compartilhar 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.

Syntax

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

Description

Esse 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. 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 foram feitas alterações nas pastas desde o tempo 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.

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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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 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.

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

Você pode canalizar uma cadeia de caracteres usada como nome de arquivo do catálogo para esse 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.