Condividi tramite

Update-ScriptFileInfo

  • Riferimento
Modulo:
PowerShellGet

Aggiornamenti informazioni per uno script.

Sintassi

Update-ScriptFileInfo
      [-Path] <String>
      [-Version <String>]
      [-Author <String>]
      [-Guid <Guid>]
      [-Description <String>]
      [-CompanyName <String>]
      [-Copyright <String>]
      [-RequiredModules <Object[]>]
      [-ExternalModuleDependencies <String[]>]
      [-RequiredScripts <String[]>]
      [-ExternalScriptDependencies <String[]>]
      [-Tags <String[]>]
      [-ProjectUri <Uri>]
      [-LicenseUri <Uri>]
      [-IconUri <Uri>]
      [-ReleaseNotes <String[]>]
      [-PrivateData <String>]
      [-PassThru]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-ScriptFileInfo
      [-LiteralPath] <String>
      [-Version <String>]
      [-Author <String>]
      [-Guid <Guid>]
      [-Description <String>]
      [-CompanyName <String>]
      [-Copyright <String>]
      [-RequiredModules <Object[]>]
      [-ExternalModuleDependencies <String[]>]
      [-RequiredScripts <String[]>]
      [-ExternalScriptDependencies <String[]>]
      [-Tags <String[]>]
      [-ProjectUri <Uri>]
      [-LicenseUri <Uri>]
      [-IconUri <Uri>]
      [-ReleaseNotes <String[]>]
      [-PrivateData <String>]
      [-PassThru]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Il Update-ScriptFileInfo cmdlet aggiorna i valori delle proprietà di uno script. Ad esempio, i valori per la versione, l'autore o la descrizione.

Questo è un cmdlet proxy per il Update-PSScriptFileInfo cmdlet in Microsoft.PowerShell.PSResourceGet. Per altre informazioni, vedere Update-PSScriptFileInfo.

Esempio

Esempio 1: Aggiornare la versione di un file di script

In questo esempio viene aggiornato un file di script esistente con nuovi valori di proprietà.

Splatting viene usato per passare i parametri al Update-ScriptFileInfo cmdlet. Per altre informazioni, vedere about_Splatting.

$Parms = @{
  Path = "C:\Test\Temp-Scriptfile.ps1"
  Version = "2.0"
  Author = "bob@contoso.com"
  CompanyName = "Contoso"
  Description = "This is the updated description"
  }
Update-ScriptFileInfo @Parms -PassThru

<#PSScriptInfo

.VERSION 2.0

.GUID 4609f00c-e850-4d3f-9c69-3741e56e4133

.AUTHOR bob@contoso.com

.COMPANYNAME Contoso

.COPYRIGHT

.TAGS

.LICENSEURI

.PROJECTURI

.ICONURI

.EXTERNALMODULEDEPENDENCIES

.REQUIREDSCRIPTS

.EXTERNALSCRIPTDEPENDENCIES

.RELEASENOTES

.PRIVATEDATA

#>

<#

.DESCRIPTION
This is the updated description

#>
Param()

$Parms archivia i valori dei parametri per Path, Version, Author, CompanyName e Description. Update-ScriptFileInfo ottiene i valori dei parametri da @Parms e aggiorna lo script. Il parametro PassThru visualizza il contenuto dello script nella console di PowerShell.

Parametri

-Author

Specifica l'autore dello script.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CompanyName

Specifica l'azienda o il fornitore che ha creato lo script.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Il cmdlet proxy ignora questo parametro perché non è supportato da Update-PSScriptFileInfo.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Copyright

Specifica un'istruzione di copyright per lo script.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Specifica una descrizione per lo script.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExternalModuleDependencies

Specifica una matrice di dipendenze del modulo esterno.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExternalScriptDependencies

Specifica una matrice di dipendenze di script esterni.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Il cmdlet proxy ignora questo parametro perché non è supportato da Update-PSScriptFileInfo.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Guid

Specifica un ID univoco per uno script.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IconUri

Specifica l'URL di un'icona per lo script. L'icona specificata viene visualizzata nella pagina Web della raccolta per lo script.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LicenseUri

Specifica l'URL delle condizioni di licenza.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LiteralPath

Specifica un percorso di una o più posizioni. Il valore del parametro LiteralPath viene usato esattamente come viene immesso. Nessun carattere viene interpretato come carattere jolly. Se il percorso include caratteri di escape, racchiuderli tra virgolette singole. Le virgolette singole indicano a PowerShell di non interpretare i caratteri come sequenze di escape.

Il cmdlet proxy esegue il mapping di questo parametro al parametro Path di Update-PSScriptFileInfo.

Type:String
Aliases:PSPath
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Il cmdlet proxy ignora questo parametro perché non è supportato da Update-PSScriptFileInfo.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Specifica il percorso del file di script. I caratteri jolly sono consentiti.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-PrivateData

Specifica i dati privati per lo script.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProjectUri

Specifica l'URL di una pagina Web relativa a questo progetto.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReleaseNotes

Specifica una matrice di stringhe che contiene note sulla versione o commenti desiderati per questa versione dello script.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RequiredModules

Specifica i moduli che devono essere nello stato sessione globale. Se i moduli necessari non sono nello stato della sessione globale, PowerShell li importa.

Type:Object[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RequiredScripts

Specifica una matrice di script necessari.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tags

Specifica una matrice di tag.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Version

Specifica la versione dello script.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Il cmdlet proxy ignora questo parametro perché non è supportato da Update-PSScriptFileInfo.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

String

Output

Object

Note

Usare il cmdlet per convalidare i Test-ScriptFileInfo metadati di uno script. Gli script devono includere valori per Version, GUID, Description e Author.