Partilhar via

Test-PSScriptFileInfo

  • Referência
Módulo:
Microsoft.PowerShell.PSResourceGet

Testa os metadados baseados em comentários num .ps1 ficheiro para garantir que são válidos para publicação.

Sintaxe

Test-PSScriptFileInfo
    [-Path] <String>
    [<CommonParameters>]

Description

Este cmdlet testa os metadados baseados em comentários num .ps1 ficheiro para garantir que é válido para publicação num repositório.

Exemplos

Exemplo 1: Testar um script válido

Este exemplo cria um novo ficheiro de script e, em seguida, é executado Test-PSScriptFile para validar os metadados no script.

New-PSScriptFileInfo -Path "C:\MyScripts\test_script.ps1" -Description "this is a test script"
Test-PSScriptFileInfo -Path "C:\MyScripts\test_script.ps1"
True

Exemplo 2: Testar um script inválido (Autor em falta)

Este exemplo executa o Test-PSScriptFile cmdlet num ficheiro de script. O script não tem os metadados de Autor necessários. O cmdlet escreve uma mensagem de aviso e devolve $false. Get-Content é utilizado para ver o conteúdo do ficheiro de script.

Test-PSScriptFileInfo -Path "C:\MyScripts\invalid_test_script.ps1"
Get-Content "C:\MyScripts\invalid_test_script.ps1"

WARNING: The .ps1 script file passed in wasn't valid due to: PSScript file is missing the required
Author property
False
<#PSScriptInfo

.VERSION 1.0.0.0

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

.AUTHOR

.COMPANYNAME

.COPYRIGHT

.TAGS

.LICENSEURI

.PROJECTURI

.ICONURI

.EXTERNALMODULEDEPENDENCIES

.REQUIREDSCRIPTS

.EXTERNALSCRIPTDEPENDENCIES

.RELEASENOTES

.PRIVATEDATA

#>

<#

.DESCRIPTION
this is a test script

#>

Parâmetros

-Path

O caminho para o .ps1 ficheiro de script.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Saídas

Boolean

Notas

Os New-PSScriptFileInfo cmdlets e Update-PSScriptFileInfo colocam as instruções para os #requires módulos necessários entre os <#PSScriptInfo blocos de ajuda baseados em comentários e do ficheiro de ajuda. Espera Get-PSScriptFileInfo que as declarações #requires sejam colocadas algures antes do bloco de ajuda baseado em comentários. Todas #requires as declarações colocadas após o bloco de ajuda baseado em comentários são ignoradas por Get-PSScriptFileInfo e Publish-PSResource.