Update-PSScriptFileInfo

Modül:

Microsoft.PowerShell.PSResourceGet Module

Bu cmdlet, var olan bir betik .ps1 dosyasındaki açıklama tabanlı meta verileri güncelleştirir.

Syntax

Default (Varsayılan)

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

Bu cmdlet, var olan bir betik .ps1 dosyasındaki açıklama tabanlı meta verileri güncelleştirir. Bu, Update-ModuleManifestbenzer.

Örnekler

Örnek 1: Betiğin sürümünü güncelleştirme

Bu örnekte, Sürüm1.0.0.0olarak ayarlanmış bir betik oluşturulur. Update-PSScriptFileInfo Sürüm' 2.0.0.0olarak değiştirir. Get-Content cmdlet'i betiğin güncelleştirilmiş içeriğini gösterir.

$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

#>

Parametreler

-Author

Betiğin yazarının adı.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-CompanyName

Betiğin sahibi olan şirketin adı.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Copyright

Betiğin telif hakkı bilgileri.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Description

Betiğin açıklaması.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ExternalModuleDependencies

Bu betik tarafından alınan dış modül bağımlılıklarının listesi.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ExternalScriptDependencies

Bu betik tarafından alınan dış betik bağımlılıklarının listesi.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Guid

GUID biçimindeki betiğin benzersiz tanımlayıcısı.

Parametre özellikleri

Tür:	Guid
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-IconUri

Betikle ilişkilendirilmiş simgeyi gösteren Tekdüzen Kaynak Tanımlayıcısı (URI).

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-LicenseUri

Betikle ilişkilendirilmiş lisans sözleşmesi dosyasına işaret eden URI.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Path

Betiğin dosya adı ve konumu.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-PrivateData

Betikle ilişkili özel veriler.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ProjectUri

Betikle ilişkilendirilmiş proje sitesine işaret eden URI.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ReleaseNotes

Betiğin sürüm notları.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-RemoveSignature

İmzayı imzalı bir .ps1 dosyasından kaldırarak betiği güncelleştirmenizi sağlar. Dosyayı güncelleştirdikten sonra yeniden imzalamanız gerekir.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-RequiredModules

parametresi, modül belirtimi karma tablolarından oluşan bir dizi alır. Modül belirtimi, aşağıdaki anahtarlara sahip bir karma tablodur.

• ModuleName - Gerekli Modül adını belirtir.
• GUID - İsteğe bağlı Modülün GUID değerini belirtir.
• Ayrıca aşağıdaki üç anahtardan en az birini belirtmek için Gerekli .
  • ModuleVersion - Modülün kabul edilebilir en düşük sürümünü belirtir.
  • MaximumVersion - Modülün kabul edilebilir en yüksek sürümünü belirtir.
  • RequiredVersion - Modülün tam ve gerekli bir sürümünü belirtir. Bu, diğer Sürüm anahtarlarıyla kullanılamaz.

Parametre özellikleri

Tür:	Hashtable[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-RequiredScripts

Betiğin gerektirdiği betiklerin listesi.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Tags

Betikle ilişkilendirilmiş etiketler. Etiket değerleri boşluk içermemesi gereken dizelerdir. Daha fazla bilgi için bkz. Etiket ayrıntıları.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Etiket

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Version

Betiğin sürümü.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

None

Çıkışlar

Object

Notlar

New-PSScriptFileInfo ve Update-PSScriptFileInfo cmdlet'leri, yardım dosyasının #requires ve açıklama tabanlı yardım blokları arasına gerekli modüller için <#PSScriptInfo deyimlerini yerleştirir. Get-PSScriptFileInfo, #requires deyimlerinin açıklama tabanlı yardım bloğundan önce bir yere yerleştirilmesini bekler. Açıklama tabanlı yardım bloğundan sonra yerleştirilen tüm #requires deyimleri Get-PSScriptFileInfo ve Publish-PSResourcetarafından yoksayılır.

İlişkili Bağlantılar

• Get-PSScriptFileInfo
• Update-PSScriptFileInfo
• Test-PSScriptFileInfo
• PowerShellGallery Yayımlama Yönergeleri ve En İyi Yöntemler
• PowerShell Galerisi kullanıcı arabirimini etkileyen paket bildirim değerleri