Install-Script

Başvuru

Modül:: PowerShellGet

Bir betik yükler.

Sözdizimi

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

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, Microsoft.PowerShell.PSResourceGet içindeki cmdlet için Install-PSResource 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 Required-Script2için cmdlet'ini kullanır Get-Command ve ardından sonuçları görüntüler.

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

Beşinci komut, çıkışı biçimlendirmek üzere cmdlet'e geçirmek için Format-List işlem hattı işlecini alır Required-Script2 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 Format-List işlem hattı işlecini alır Required-Script3 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.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Confirm

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

Tür:	SwitchParameter
Diğer adlar:	cf
Position:	Named
Default value:	False
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Credential

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

Tür:	PSCredential
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Force

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

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	PSObject[]
Position:	0
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-MaximumVersion

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

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-MinimumVersion

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

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Name

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

Tür:	String[]
Position:	0
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-NoPathUpdate

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

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Proxy

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

Tür:	Uri
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-ProxyCredential

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

Tür:	PSCredential
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	False

-Repository

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

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-RequiredVersion

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

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	True
Joker karakterleri kabul et:	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.

Tür:	String
Kabul edilen değerler:	CurrentUser, AllUsers
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-WhatIf

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

Tür:	SwitchParameter
Diğer adlar:	wi
Position:	Named
Default value:	False
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

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.

Aracılığıyla paylaş

Install-Script

Sözdizimi

Description

Örnekler

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

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

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

Parametreler

-AcceptLicense

-AllowPrerelease

-Confirm

-Credential

-Force

-InputObject

-MaximumVersion

-MinimumVersion

-Name

-NoPathUpdate

-PassThru

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Scope

-WhatIf

Girişler

Çıkışlar

Notlar

İlişkili Bağlantılar

Geri Bildirim