Update-PSScriptFileInfo
Met deze cmdlet worden de metagegevens op basis van opmerkingen bijgewerkt in een bestaand script .ps1 bestand.
Syntaxis
Default (Standaard)
Update-PSScriptFileInfo
[-Author <String>]
[-CompanyName <String>]
[-Copyright <String>]
[-Description <String>]
[-ExternalModuleDependencies <String[]>]
[-ExternalScriptDependencies <String[]>]
[-Guid <Guid>]
[-IconUri <String>]
[-LicenseUri <String>]
[-Path] <String>
[-PrivateData <String>]
[-ProjectUri <String>]
[-ReleaseNotes <String>]
[-RemoveSignature]
[-RequiredModules <Hashtable[]>]
[-RequiredScripts <String[]>]
[-Tags <String[]>]
[-Version <String>]
[<CommonParameters>]
Description
Met deze cmdlet worden de metagegevens op basis van opmerkingen bijgewerkt in een bestaand script .ps1 bestand. Dit is vergelijkbaar met Update-ModuleManifest.
Voorbeelden
Voorbeeld 1: De versie van een script bijwerken
In dit voorbeeld wordt een script gemaakt met versie ingesteld op 1.0.0.0.
Update-PSScriptFileInfo wijzigt de versie ' in 2.0.0.0. De Get-Content cmdlet toont de bijgewerkte inhoud van het script.
$parameters = @{
FilePath = "C:\Users\johndoe\MyScripts\test_script.ps1"
Version = "1.0.0.0"
Description = "this is a test script"
}
New-PSScriptFileInfo @parameters
$parameters.Version = "2.0.0.0"
Update-PSScriptFileInfo @parameters
Get-Content $parameters.FilePath
<#PSScriptInfo
.VERSION 2.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
#>
Parameters
-Author
De naam van de auteur van het script.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-CompanyName
De naam van het bedrijf dat eigenaar is van het script.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-Copyright
De copyrightinformatie voor het script.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-Description
De beschrijving van het script.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-ExternalModuleDependencies
De lijst met externe moduleafhankelijkheden die door dit script worden genomen.
Parametereigenschappen
Type: String [ ]
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-ExternalScriptDependencies
De lijst met externe scriptafhankelijkheden die door dit script worden genomen.
Parametereigenschappen
Type: String [ ]
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-Guid
De unieke id voor het script in GUID-indeling.
Parametereigenschappen
Type: Guid
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-IconUri
Een URI (Uniform Resource Identifier) die verwijst naar het pictogram dat aan het script is gekoppeld.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-LicenseUri
De URI die verwijst naar het licentieovereenkomstbestand dat is gekoppeld aan het script.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-Path
De bestandsnaam en locatie van het script.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: 0
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-PrivateData
De persoonlijke gegevens die aan het script zijn gekoppeld.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-ProjectUri
De URI die verwijst naar de projectsite die is gekoppeld aan het script.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-ReleaseNotes
De releaseopmerkingen voor het script.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-RemoveSignature
Hiermee verwijdert u de handtekening uit een ondertekend .ps1-bestand, zodat u het script kunt bijwerken. Meld u opnieuw aan na het bijwerken van het bestand.
Parametereigenschappen
Type: SwitchParameter
Default value: False
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-RequiredModules
De parameter neemt een matrix van modulespecificatie-hashtabellen. Een modulespecificatie is een hashtabel met de volgende sleutels.
ModuleName
-
Vereist Geeft de modulenaam op.
GUID
-
Optionele Geeft de GUID van de module aan.
Het is ook vereist om ten minste een van de drie onderstaande sleutels op te geven.
ModuleVersion - Hiermee geeft u een minimaal acceptabele versie van de module op.
MaximumVersion - Hiermee geeft u de maximaal acceptabele versie van de module.
RequiredVersion - Hiermee geeft u een exacte, vereiste versie van de module op. Dit kan niet worden gebruikt met de andere versiesleutels.
Parametereigenschappen
Type: Hashtable [ ]
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-RequiredScripts
De lijst met scripts die vereist zijn voor het script.
Parametereigenschappen
Type: String [ ]
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
De tags die aan het script zijn gekoppeld. Tagwaarden zijn tekenreeksen die geen spaties mogen bevatten. Zie Tagdetails voor meer informatie.
Type: String [ ]
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Aliassen: Etiket
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-Version
De versie van het script.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParameters voor meer informatie.
None
Uitvoerwaarden
Notities
De cmdlets New-PSScriptFileInfo en Update-PSScriptFileInfo plaatsen de #requires instructies voor vereiste modules tussen de helpblokken <#PSScriptInfo en op opmerkingen gebaseerde helpblokken van het Help-bestand.
De Get-PSScriptFileInfo verwacht dat #requires instructies ergens vóór het helpblok op basis van opmerkingen worden geplaatst. Alle #requires instructies die na het hulpblok op basis van opmerkingen worden geplaatst, worden genegeerd door Get-PSScriptFileInfo en Publish-PSResource.