New-FileCatalog
Crea un file di catalogo Windows contenente hash crittografici per file e cartelle nei percorsi specificati.
Sintassi
Default (Impostazione predefinita)
New-FileCatalog
[-CatalogVersion <Int32>]
[-CatalogFilePath] <String>
[[-Path] <String[]>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
New-FileCatalog crea un file di catalogo 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.
Importante
I cataloghi basati su SHA1 sono deprecati e non devono essere considerati attendibili per i flussi di lavoro sensibili alla sicurezza.
Esempio
Esempio 1: Creare un catalogo file per '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
Parametri
-CatalogFilePath
Percorso e nome del file di catalogo (.cat) che si sta creando. Se si specifica solo un percorso di cartella, il comando crea un file denominato catalog.cat in tale percorso.
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 il più possibile valori per specificare la versione del catalogo. Version 2.0 usa l'algoritmo SHA-256 sicuro.
Importante
I cataloghi basati su SHA1 (versione 1.0) sono deprecati e non devono essere considerati attendibili per i flussi di lavoro sensibili alla sicurezza.
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. Quando si specifica una cartella, il comando enumera il contenuto della cartella in modo ricorsivo per includere tutte le sottocartelle e il relativo contenuto. Il file di catalogo contiene percorsi relativi ai file inclusi nel catalogo.
Importante
Quando si specifica un elenco di file o cartelle, il cmdlet non può calcolare un percorso relativo perché i file e le cartelle possono trovarsi in qualsiasi punto del file system. In questa condizione, il cmdlet usa solo il nome file per l'hash, il che significa che non è possibile avere nomi file duplicati in percorsi diversi. Per ottenere risultati ottimali, passare una singola cartella e consentire al cmdlet di enumerare il contenuto. Il cmdlet usa il percorso iniziale per calcolare i percorsi relativi in modo che i nomi file duplicati siano ancora univoci all'interno dell'albero delle cartelle.
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
È possibile inviare tramite pipe una stringa usata come nome file del catalogo a questo cmdlet.
Output
FileInfo
Questo cmdlet restituisce un oggetto FileInfo che rappresenta il catalogo creato.
