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.
Sintaxe
Default (Default)
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 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 Windows 7. Você deve usar a versão 2 do catálogo em Windows 8, Windows Server 2012 e 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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-CatalogVersion
Aceita 1.0 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 Server 2008R2.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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
O pipeline usa uma cadeia de caracteres que é usada como o nome do arquivo de catálogo.
Saídas
FileInfo
Observações
Este cmdlet está disponível apenas em plataformas Windows.