Install-Script

Modül:

PowerShellGet v3 Module

Bir betik yükler.

Sözdizimi

NameParameterSet EnterprisePublishing

Install-Script
    [-Name] <String[]>
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-Repository <String[]>]
    [-Scope <String>]
    [-NoPathUpdate]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AllowPrerelease]
    [-AcceptLicense]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObject

Install-Script
    [-InputObject] <PSObject[]>
    [-Scope <String>]
    [-NoPathUpdate]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Credential <PSCredential>]
    [-Force]
    [-AcceptLicense]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Install-Script Cmdlet bir depodan bir betik yükü alır, yükün geçerli bir PowerShell betiği olduğunu doğrular ve betik dosyasını belirtilen yükleme konumuna kopyalar.

Bu, Install-PSResource içindeki cmdlet için bir proxy cmdlet'idir. Daha fazla bilgi için bkz . Install-PSResource.

Örnekler

Örnek 1: Betiği bulma ve yükleme

PS C:\> Find-Script -Repository "Local1" -Name "Required-Script2"
Version    Name                           Type       Repository           Description
-------    ----                           ----       ----------           -----------
2.5        Required-Script2               Script     local1               Description for the Required-Script2 script

PS C:\> Find-Script -Repository "Local1" -Name "Required-Script2" | Install-Script
PS C:\> Get-Command -Name "Required-Script2"
CommandType     Name                      Version    Source
-----------     ----                      -------    ------
ExternalScript  Required-Script2.ps1      2.0       C:\Users\pattif\Documents\WindowsPowerShell\Scripts\Required-Script2.ps1

PS C:\> Get-InstalledScript -Name "Required-Script2"
Version    Name                  Type     Repository           Description
-------    ----                  ----     ----------           -----------
2.5        Required-Script2      Script   local1               Description for the Required-Script2 script

PS C:\> Get-InstalledScript -Name "Required-Script2" | Format-List *
Name                       : Required-Script2
Version                    : 2.5
Type                       : Script
Description                : Description for the Required-Script2 script
Author                     : pattif
CompanyName                :
Copyright                  : 2015 Microsoft Corporation. All rights reserved.
PublishedDate              : 8/15/2015 12:42:39 AM
LicenseUri                 : http://required-script2.com/license
ProjectUri                 : http://required-script2.com/
IconUri                    : http://required-script2.com/icon
Tags                       : {Tag1, Tag2, Tag-Required-Script2-2.5, PSScript...}
Includes                   : {Function, DscResource, Cmdlet, Command}
PowerShellGetFormatVersion :
ReleaseNotes               : Required-Script2 release notes
Dependencies               : {}
RepositorySourceLocation   : http://pattif-dev:8765/api/v2/
Repository                 : local1
PackageManagementProvider  : NuGet
InstalledLocation          : C:\Users\pattif\Documents\WindowsPowerShell\Scripts

İlk komut, Local1 deposundan adlı Required-Script2 betiği bulur ve sonuçları görüntüler.

İkinci komut betiği bulur Required-Script2 ve ardından işlem hattı işlecini kullanarak yüklemek üzere Install-Script cmdlet'e geçirir.

Üçüncü komut, almak Get-Commandiçin cmdlet'ini kullanır Required-Script2 ve ardından sonuçları görüntüler.

Dördüncü komut, sonuçları almak Get-InstalledScript ve görüntülemek için cmdlet'ini kullanırRequired-Script2.

Beşinci komut, çıkışı biçimlendirmek üzere cmdlet'e geçirmek için Required-Script2 işlem hattı işlecini alır Format-List ve kullanır.

Örnek 2: AllUsers kapsamına sahip bir betik yükleme

PS C:\> Install-Script -Repository "Local1" -Name "Required-Script3" -Scope "AllUsers"
PS C:\> Get-InstalledScript -Name "Required-Script3"
Version    Name                  Type       Repository    Description
-------    ----                  ----       ----------    -----------
2.5        Required-Script3      Script     local1        Description for the Required-Script3 script

PS C:\> Get-InstalledScript -Name "Required-Script3" | Format-List *
Name                       : Required-Script3
Version                    : 2.5
Type                       : Script
Description                : Description for the Required-Script3 script
Author                     : pattif
CompanyName                :
Copyright                  : 2015 Microsoft Corporation. All rights reserved.
PublishedDate              : 8/15/2015 12:42:45 AM
LicenseUri                 : http://required-script3.com/license
ProjectUri                 : http://required-script3.com/
IconUri                    : http://required-script3.com/icon
Tags                       : {Tag1, Tag2, Tag-Required-Script3-2.5, PSScript...}
Includes                   : {Function, DscResource, Cmdlet, Command}
PowerShellGetFormatVersion :
ReleaseNotes               : Required-Script3 release notes
Dependencies               : {}
RepositorySourceLocation   : http://pattif-dev:8765/api/v2/
Repository                 : local1
PackageManagementProvider  : NuGet
InstalledLocation          : C:\Program Files\WindowsPowerShell\Scripts

İlk komut adlı Required-Script3 betiği yükler ve AllUsers kapsamı atar.

İkinci komut yüklü betiği alır ve bu komutla Required-Script3 ilgili bilgileri görüntüler.

Üçüncü komut, çıkışı biçimlendirmek üzere cmdlet'ine geçirmek için Required-Script3 işlem hattı işlecini alır Format-List ve kullanır.

Örnek 3: Betik ve bağımlılıklarını yükleme

PS C:\> Find-Script -Repository "Local1" -Name "Script-WithDependencies2" -IncludeDependencies
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.0        Script-WithDependencies2    Script     local1        Description for the Script-WithDependencies2 script
2.5        RequiredModule1             Module     local1        RequiredModule1 module
2.5        RequiredModule2             Module     local1        RequiredModule2 module
2.5        RequiredModule3             Module     local1        RequiredModule3 module
2.5        Required-Script1            Script     local1        Description for the Required-Script1 script
2.5        Required-Script2            Script     local1        Description for the Required-Script2 script
2.5        Required-Script3            Script     local1        Description for the Required-Script3 script

PS C:\> Install-Script -Repository "Local1" -Name "Script-WithDependencies2"
PS C:\> Get-InstalledScript
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.5        Required-Script1            Script     local1        Description for the Required-Script1 script
2.5        Required-Script2            Script     local1        Description for the Required-Script2 script
2.5        Required-Script3            Script     local1        Description for the Required-Script3 script
2.0        Script-WithDependencies2    Script     local1        Description for the Script-WithDependencies2 script

PS C:\> Get-InstalledModule
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.5        RequiredModule1             Module     local1        RequiredModule1 module
2.5        RequiredModule2             Module     local1        RequiredModule2 module
2.5        RequiredModule3             Module     local1        RequiredModule3 module

PS C:\> Find-Script -Repository "Local1" -Name "Required-Script*"
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.5        Required-Script1            Script     local1        Description for the Required-Script1 script
2.5        Required-Script2            Script     local1        Description for the Required-Script2 script
2.5        Required-Script3            Script     local1        Description for the Required-Script3 script

PS C:\> Install-Script -Repository "Local1" -Name "Required-Script*"
PS C:\> Get-InstalledScript
Version    Name                        Type       Repository    Description
-------    ----                        ----       ----------    -----------
2.5        Required-Script1            Script     local1        Description for the Required-Script1 script
2.5        Required-Script2            Script     local1        Description for the Required-Script2 script
2.5        Required-Script3            Script     local1        Description for the Required-Script3 script

İlk komut, adlı Script-WithDependencies2 betiği ve bağımlılıklarını Local1 deposunda bulur ve sonuçları görüntüler.

İkinci komut yükler Script-WithDependencies2.

Üçüncü komut, yüklü betikleri almak ve sonuçları görüntülemek için betik cmdlet'ini kullanır Get-InstalledScript .

Dördüncü komut, yüklü modülleri almak ve sonuçları görüntülemek için cmdlet'ini kullanır Get-InstalledModule .

Beşinci komut, adın Find-Script başladığı Required-Script betikleri bulmak ve sonuçları görüntülemek için cmdlet'ini kullanır.

Altıncı komut, adın Local1 deposunda başladığı Required-Script betikleri yükler.

Son komut yüklü betikleri alır ve sonuçları görüntüler.

Parametreler

-AcceptLicense

Modül gerektiriyorsa, yükleme sırasında lisans sözleşmesini otomatik olarak kabul edin.

Parametre özellikleri

Tür:	SwitchParameter
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

-AllowPrerelease

Ön sürüm olarak işaretlenmiş bir betik yüklemenize olanak tanır.

Proxy cmdlet'i bu parametreyi ön sürüm parametresiyle eşler Install-PSResource.

Parametre özellikleri

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

Parametre kümeleri

NameParameterSet

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

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Cf

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

-Credential

Belirtilen paket sağlayıcısı veya kaynağı için betik yükleme haklarına sahip bir kullanıcı hesabı belirtir.

Parametre özellikleri

Tür:	PSCredential
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:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Force

proxy cmdlet'i tarafından Install-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

Parametre özellikleri

Tür:	SwitchParameter
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

-InputObject

İşlem hattı girişi için kullanılır. InputObject'e doğrudan bir değer sağlanırsa bir hata oluşur. InputObject parametresiyle nesneleri geçirmek için işlem hattını kullanın.

Parametre özellikleri

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

Parametre kümeleri

InputObject

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

-MaximumVersion

Proxy cmdlet'i bu parametrenin değerini kullanarak version parametresiyleInstall-PSResourcekullanılacak bir NuGet sürüm arama dizesi oluşturur.

Parametre özellikleri

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

Parametre kümeleri

NameParameterSet

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

-MinimumVersion

Proxy cmdlet'i bu parametrenin değerini kullanarak version parametresiyleInstall-PSResourcekullanılacak bir NuGet sürüm arama dizesi oluşturur.

Parametre özellikleri

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

Parametre kümeleri

NameParameterSet

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

-Name

Yüklenecek betik adlarının bir dizisini belirtir.

Parametre özellikleri

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

Parametre kümeleri

NameParameterSet

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

-NoPathUpdate

proxy cmdlet'i tarafından Install-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

Parametre özellikleri

Tür:	SwitchParameter
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

-PassThru

PassThru parametresini kullanırken, Install-Script modül için bir PSRepositoryItemInfo nesnesi çıkartır. Bu, cmdlet'inden edindiğiniz bilgilerle Find-Script aynıdır.

Parametre özellikleri

Tür:	SwitchParameter
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

-Proxy

proxy cmdlet'i tarafından Install-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

Parametre özellikleri

Tür:	Uri
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:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ProxyCredential

proxy cmdlet'i tarafından Install-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

Parametre özellikleri

Tür:	PSCredential
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:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Repository

cmdlet'ine kaydedilmiş bir deponun Register-PSRepository kolay adını belirtir. Varsayılan olarak tüm kayıtlı depolar kullanılır.

Parametre özellikleri

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

Parametre kümeleri

NameParameterSet

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

-RequiredVersion

Proxy cmdlet'i bu parametrenin değerini kullanarak version parametresiyleInstall-PSResourcekullanılacak bir NuGet sürüm arama dizesi oluşturur.

Parametre özellikleri

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

Parametre kümeleri

NameParameterSet

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

-Scope

Betiğin yükleme kapsamını belirtir. Geçerli değerler şunlardır: AllUsers ve CurrentUser.

AllUsers kapsamı, modüllerin bilgisayarın tüm kullanıcıları tarafından erişilebilen bir konuma yüklenmesine olanak tanır. $env:ProgramFiles\WindowsPowerShell\Scripts

CurrentUser kapsamı modüllerin yalnızca öğesine yüklenmesini $HOME\Documents\WindowsPowerShell\Scriptssağlar, böylece modül yalnızca geçerli kullanıcının kullanımına sunulur.

Kapsam tanımlanmadığında varsayılan ayar geçerli oturuma göre yapılır:

• Yükseltilmiş bir PowerShell oturumu için Kapsam varsayılan olarak AllUsers olur;
• PowerShellGet 2.0.0 ve üzeri sürümlerdeki yükseltilmiş olmayan PowerShell oturumları için Kapsam CurrentUser'dır;
• PowerShellGet 1.6.7 ve önceki sürümlerdeki yükseltilmiş olmayan PowerShell oturumları için Kapsam tanımlanmamıştır ve Install-Module başarısız olur.

Parametre özellikleri

Tür:	String
Default value:	None
Kabul edilen değerler:	CurrentUser, AllUsers
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

-WhatIf

Cmdlet çalıştırılırsa ne olacağını gösterir. Cmdlet çalıştırılmaz.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Wi

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

String

PSObject

String

Uri

PSCredential

Çıkışlar

Object

Notlar

Önemli

Nisan 2020 itibarıyla PowerShell Galerisi artık Aktarım Katmanı Güvenliği (TLS) 1.0 ve 1.1 sürümlerini desteklememektedir. TLS 1.2 veya üzerini kullanmıyorsanız PowerShell Galerisi'ne erişmeye çalışırken hata alırsınız. TLS 1.2 kullandığınızdan emin olmak için aşağıdaki komutu kullanın:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Daha fazla bilgi için PowerShell blogunda duyuru bakın.

İlişkili Bağlantılar

• Find-Script
• Publish-Script
• Save-Script
• Uninstall-Script
• Update-Script