Partilhar via

New-FileCatalog

Módulo:
Microsoft.PowerShell.Security Module

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

Sintaxe

Default (Predefinição) 

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 de 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'

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 onde o arquivo de catálogo (.cat) deve ser colocado. Se um caminho de pasta for especificado, o nome do arquivo catalog.cat padrão será usado.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-CatalogVersion

Aceita 1.0 ou 2.0 como 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 seguro SHA-256 No entanto, 1.0 é o único algoritmo suportado no Windows 7 e Server 2008R2.

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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, todos os arquivos na pasta também serão incluídos.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:1
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

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

Saídas

FileInfo

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

Notas

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