Partilhar via


Update-ScriptFileInfo

Atualizações informações para um script.

Syntax

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>]

Description

O Update-ScriptFileInfo cmdlet atualiza os valores de propriedade de um script. Por exemplo, os valores para a versão, autor ou descrição.

Este é um cmdlet proxy para o Update-PSScriptFileInfo cmdlet no Microsoft.PowerShell.PSResourceGet. Para obter mais informações, veja Update-PSScriptFileInfo.

Exemplos

Exemplo 1: atualizar a versão de um ficheiro de script

Neste exemplo, um ficheiro de script existente é atualizado com novos valores de propriedade.

O splatting é utilizado para transmitir parâmetros para o Update-ScriptFileInfo cmdlet . Para obter mais informações, veja 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 armazena os valores de parâmetros para Path, Version, Author, CompanyName e Description. Update-ScriptFileInfo obtém os valores dos parâmetros de @Parms e atualiza o script. O parâmetro PassThru apresenta os conteúdos do script na consola do PowerShell.

Parâmetros

-Author

Especifica o autor do script.

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

-CompanyName

Especifica a empresa ou o fornecedor que criou o script.

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

-Confirm

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo Update-PSScriptFileInfo.

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

Especifica uma declaração de direitos de autor para o script.

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

-Description

Especifica uma descrição para o script.

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

-ExternalModuleDependencies

Especifica uma matriz de dependências de módulos externos.

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

-ExternalScriptDependencies

Especifica uma matriz de dependências de script externo.

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

-Force

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo Update-PSScriptFileInfo.

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

-Guid

Especifica um ID exclusivo para um script.

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

-IconUri

Especifica o URL de um ícone para o script. O ícone especificado é apresentado na página Web da galeria do script.

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

-LicenseUri

Especifica o URL dos termos de licenciamento.

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

-LiteralPath

Especifica um caminho para uma ou mais localizações. O valor do parâmetro LiteralPath é utilizado exatamente como é introduzido. Não são interpretados carateres universais. Se o caminho incluir carateres de escape, coloque-os entre plicas. As aspas únicas indicam ao PowerShell para não interpretar os carateres como sequências de escape.

O cmdlet proxy mapeia este parâmetro para o parâmetro Path de Update-PSScriptFileInfo.

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

-PassThru

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo Update-PSScriptFileInfo.

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

-Path

Especifica a localização do ficheiro de script. São permitidos carateres universais.

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

-PrivateData

Especifica os dados privados do script.

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

-ProjectUri

Especifica o URL de uma página Web sobre este projeto.

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

-ReleaseNotes

Especifica uma matriz de cadeia que contém notas de versão ou comentários que pretende que estejam disponíveis para esta versão do script.

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

-RequiredModules

Especifica módulos que têm de estar no estado de sessão global. Se os módulos necessários não estiverem no estado de sessão global, o PowerShell importa-os.

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

-RequiredScripts

Especifica uma matriz de scripts necessários.

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

-Tags

Especifica uma matriz de etiquetas.

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

-Version

Especifica a versão do script.

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

-WhatIf

O cmdlet proxy ignora este parâmetro, uma vez que não é suportado pelo Update-PSScriptFileInfo.

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

Entradas

String

Saídas

Object

Notas

Utilize o Test-ScriptFileInfo cmdlet para validar os metadados de um script. Os scripts têm de incluir valores para Versão, GUID, Descrição e Autor.