New-FileCatalog
New-FileCatalog crea un file di catalogo di hash di file che può essere usato per convalidare l'autenticità di un file.
Sintassi
Default (Impostazione predefinita)
New-FileCatalog
[-CatalogVersion <Int32>]
[-CatalogFilePath] <String>
[[-Path] <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Questo cmdlet è disponibile solo nella piattaforma Windows.
New-FileCatalog crea un file di catalogo di Windows per un set di cartelle e file. Questo file di catalogo contiene hash per tutti i file nei percorsi specificati. Gli utenti possono quindi distribuire il catalogo con i file in modo che gli utenti possano verificare se sono state apportate modifiche alle cartelle dall'ora di creazione del catalogo.
Sono supportate le versioni 1 e 2 del catalogo. La versione 1 usa l'algoritmo hash SHA1 (deprecato) per creare hash di file e la versione 2 usa SHA256. La versione 2 del catalogo non è supportata in Windows Server 2008 R2 o Windows 7. È consigliabile utilizzare la versione 2 del catalogo in Windows 8, Windows Server 2012 e sistemi operativi successivi.
Esempio
Esempio 1: Creare un catalogo file per '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
Parametri
-CatalogFilePath
Percorso di un file o di una cartella in cui deve essere inserito il file di catalogo (con estensione cat). Se viene specificato un percorso di cartella, verrà utilizzato il nome catalog.cat file predefinito.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-CatalogVersion
Accetta 1.0 o 2.0 i valori possibili per specificare la versione del catalogo.
1.0 dovrebbe essere utilizzato evitato quando possibile, in quanto utilizza l'algoritmo hash SHA-1 non sicuro, mentre 2.0 utilizza l'algoritmo sicuro SHA-256 Tuttavia, 1.0 è l'unico algoritmo supportato su Windows 7 e Server 2008R2.
Proprietà dei parametri
| Tipo: | Int32 |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Path
Accetta un percorso o una matrice di percorsi per file o cartelle che devono essere inclusi nel file di catalogo. Se viene specificata una cartella, verranno inclusi anche tutti i file in essa contenuti.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | False |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
String
La pipeline accetta una stringa che viene utilizzata come nome del file del catalogo.
Output
FileInfo
Note
Questo cmdlet è disponibile solo nelle piattaforme Windows.