Condividi tramite

New-PSScriptFileInfo

  • Riferimento
Modulo:
Microsoft.PowerShell.PSResourceGet

Il cmdlet crea un nuovo file di script, inclusi i metadati sullo script.

Sintassi

New-PSScriptFileInfo
   [-Path] <String>
   [-Version <String>]
   [-Author <String>]
   -Description <String>
   [-Guid <Guid>]
   [-CompanyName <String>]
   [-Copyright <String>]
   [-RequiredModules <Hashtable[]>]
   [-ExternalModuleDependencies <String[]>]
   [-RequiredScripts <String[]>]
   [-ExternalScriptDependencies <String[]>]
   [-Tags <String[]>]
   [-ProjectUri <String>]
   [-LicenseUri <String>]
   [-IconUri <String>]
   [-ReleaseNotes <String>]
   [-PrivateData <String>]
   [-Force]
   [<CommonParameters>]

Descrizione

Il cmdlet crea un nuovo file di script contenente i metadati necessari per pubblicare un pacchetto script.

Esempio

Esempio 1: Creazione di uno script vuoto con informazioni minime

In questo esempio viene eseguito il cmdlet usando solo i parametri obbligatori. Il parametro Path specifica la nana e la posizione dello script. Il parametro description specificare la descrizione usata nella Guida basata su commenti per lo script.

New-PSScriptFileInfo -Path ./test_script.ps1 -Description 'This is a test script.'
Get-Content ./test_script.ps1

<#PSScriptInfo

.VERSION 1.0.0.0

.GUID 6ec3934e-a2e0-495b-9a9c-480e555ad1d1

.AUTHOR johndoe

.COMPANYNAME

.COPYRIGHT

.TAGS

.LICENSEURI

.PROJECTURI

.ICONURI

.EXTERNALMODULEDEPENDENCIES

.REQUIREDSCRIPTS

.EXTERNALSCRIPTDEPENDENCIES

.RELEASENOTES

.PRIVATEDATA

#>

<#

.DESCRIPTION
This is a test script.

#>

Esempio 2: Creazione di uno script con i moduli necessari

In questo esempio viene eseguito il cmdlet con parametri aggiuntivi, tra cui RequiredModules. RequiredModules è una matrice di specifiche del modulo.

$parameters = @{
    Path = './test_script2.ps1'
    Description = 'This is a test script.'
    Version = '2.0.0.0'
    Author = 'janedoe'
    RequiredModules =  @(
        @{ModuleName = 'PackageManagement'; ModuleVersion = '1.0.0.0' },
        @{ModuleName = 'PSReadLine'}
    )
}
New-PSScriptFileInfo @parameters
Get-Content ./test_script2.ps1

<#PSScriptInfo

.VERSION 2.0.0.0

.GUID 7ec4832e-a4e1-562b-8a8c-241e535ad7d7

.AUTHOR janedoe

.COMPANYNAME

.COPYRIGHT

.TAGS

.LICENSEURI

.PROJECTURI

.ICONURI

.EXTERNALMODULEDEPENDENCIES

.REQUIREDSCRIPTS

.EXTERNALSCRIPTDEPENDENCIES

.RELEASENOTES

.PRIVATEDATA

#>

#Requires -Module PSReadLine
#Requires -Module @{ ModuleName = 'PackageManagement'; ModuleVersion = '1.0.0.0' }

<#

.DESCRIPTION
This is a test script.

#>

Parametri

-Author

Nome dell'autore dello script.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CompanyName

Nome della società proprietaria dello script.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Copyright

Informazioni sul copyright per lo script.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Descrizione dello script.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ExternalModuleDependencies

Elenco delle dipendenze del modulo esterno eseguite da questo script.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ExternalScriptDependencies

Elenco delle dipendenze di script esterni eseguite da questo script.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Forza il cmdlet a sovrascrivere qualsiasi file esistente.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Guid

Identificatore univoco per lo script in formato GUID. Se non si specifica un GUID, il cmdlet ne crea automaticamente uno nuovo.

Tipo:Guid
Posizione:Named
Valore predefinito:Randomly generated
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-IconUri

URI (Uniform Resource Identifier) che punta all'icona associata allo script.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-LicenseUri

URI che punta al file del contratto di licenza associato allo script.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Path

Nome file e percorso in cui viene creato lo script.

Tipo:String
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PrivateData

Dati privati associati allo script.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProjectUri

URI che punta al sito del progetto associato allo script.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ReleaseNotes

Note sulla versione per lo script.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RequiredModules

Il parametro accetta una matrice di tabelle hash delle specifiche del modulo. Una specifica del modulo è una tabella hash con le chiavi seguenti.

  • ModuleName - Obbligatorio Specifica il nome del modulo.
  • GUID - Facoltativo Specifica il GUID del modulo.
  • È anche Obbligatorio specificare almeno una delle tre chiavi seguenti.
    • ModuleVersion: specifica una versione minima accettabile del modulo.
    • MaximumVersion: specifica la versione massima accettabile del modulo.
    • RequiredVersion: specifica una versione esatta e obbligatoria del modulo. Non è possibile usare questa opzione con le altre chiavi di versione.
Tipo:Hashtable[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RequiredScripts

Elenco di script richiesti dallo script.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Tags

Tag associati allo script. I valori dei tag sono stringhe che non devono contenere spazi. Per altre informazioni, vedere Dettagli tag.

Tipo:String[]
Alias:Tag
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Version

Versione dello script. Se non viene specificato alcun valore Version viene impostato per impostazione predefinita su 1.0.0.0.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

Note

I cmdlet New-PSScriptFileInfo e Update-PSScriptFileInfo inserisce le istruzioni #requires per i moduli necessari tra i blocchi della Guida <#PSScriptInfo e della Guida basata su commenti del file della Guida. Il Get-PSScriptFileInfo prevede che le istruzioni #requires vengano posizionate in un punto qualsiasi prima del blocco della Guida basata su commenti. Tutte le istruzioni #requires inserite dopo il blocco della Guida basata su commenti vengono ignorate da Get-PSScriptFileInfo e Publish-PSResource.