New-FileCatalog
Crea un file di catalogo di 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 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.
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 i valori possibili per specificare la versione del catalogo.
1.0 deve essere evitato quando possibile perché usa l'algoritmo hash SHA-1 non sicuro. La versione 2.0 usa l'algoritmo SHA-256 sicuro.
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 si specifica una cartella, il comando include tutti i file nella cartella .
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.
