Install-PSResource

  • Başvuru
Modül:
Microsoft.PowerShell.PSResourceGet

Kayıtlı bir depodan kaynakları yükler.

Sözdizimi

Install-PSResource
       [-Name] <String[]>
       [-Version <String>]
       [-Prerelease]
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       [-InputObject] <PSResourceInfo[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResourceFile <String>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResource <Object>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Bu cmdlet, kayıtlı bir depodaki kaynakları bir makinedeki yükleme yoluna yükler. Varsayılan olarak, cmdlet herhangi bir nesne döndürmez. Diğer parametreler, bir kaynak için depo, kapsam ve sürümü belirtmenize ve lisans istemlerini gizlemenize olanak sağlar.

Bu cmdlet, PowerShellGet v2'den ve Install-Script cmdlet'lerinin işlevlerini Install-Module birleştirir.

Install-PSResource yeni yüklenen modülü geçerli oturuma yüklemez. Güncelleştirilmiş modülü kullanmak için yeni sürümü içeri aktarmanız veya yeni bir oturum başlatmanız gerekir. Daha fazla bilgi için bkz . Import-Module.

Örnekler

Örnek 1

Az modülünün en son kararlı (yayın öncesi olmayan) sürümünü yükler.

Install-PSResource Az

Örnek 2

sürümleri ile 8.3.0arasında 7.3.0 en son kararlı Az modülünü yükler.

Install-PSResource Az -Version '[7.3.0, 8.3.0]'

Örnek 3

Az modülünün en son kararlı sürümünü yükler. Reinstall parametresi kullanıldığında, cmdlet önceden yüklenmiş herhangi bir sürümün üzerine yazar.

Install-PSResource Az -Reinstall

Örnek 4

psd1 dosyasında belirtilen PSResources'u yükler.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Örnek 5

Karma tablo içinde belirtilen PSResources'u yükler.

Install-PSResource -RequiredResource  @{
    TestModule = @{
        version = '[0.0.1,1.3.0]'
        repository = 'PSGallery'
      }
    TestModulePrerelease = @{
        version = '[0.0.0,0.0.5]'
        repository = 'PSGallery'
        prerelease = 'true'
    }
    TestModule99 = @{}
}

Parametreler

-AcceptLicense

Kaynağın lisans sözleşmesini kabul etme isteğini kabul etmesi gerektiğini belirtir. Bu, modülün kullanıcının lisans sözleşmesini kabul etme zorunlu olup olmadığını sormayı bastırır.

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

-AuthenticodeCheck

Windows'ta Authenticode imzalarını ve katalog dosyalarını doğrular.

Tür:SwitchParameter
Position:Named
Default value:False
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

Bir depoya erişirken kullanılan isteğe bağlı kimlik bilgileri.

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

Tür:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Diğer adlar:ParentResource
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-Name

Yüklenecek bir veya daha fazla kaynağın adı.

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

-NoClobber

Makinede zaten var olan cmdlet'leri içeren bir paketin yüklenmesini engeller.

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

-PassThru

Belirtildiğinde, kaydedilen kaynak için bir PSResourceInfo nesnesi oluşturur.

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

-Prerelease

Belirtildiğinde, döndürülen arama sonuçlarına yayın öncesi sürümleri içerir.

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

-Quiet

Yükleme ilerleme çubuğunu gizler.

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

-Reinstall

En son sürüm zaten yüklü olsa bile modülün en son sürümünü yükler. Yüklü sürümün üzerine yazılır. Bu, modülün hasarlı yüklemesini onarmanıza olanak tanır.

Modülün eski bir sürümü yüklüyse yeni sürüm, sürüme özgü yeni bir klasöre yan yana yüklenir.

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

-Repository

Aranacak bir veya daha fazla depo adını belirtir. Belirtilmezse, paketi içeren bir depo bulunana kadar arama tüm kayıtlı depoları öncelik sırasına göre (en yüksek önce) içerir. Depolar önceliğe ve sonra ada göre sıralanır. Düşük Öncelik değerleri daha yüksek önceliğe sahiptir.

Birden çok depodaki kaynakları ararken, PSResourceGet cmdlet'leri bu sıralama düzenini kullanarak depolarda arama uygular. Install-PSResource sıralanmış depo listesinden ilk eşleşen paketi yükler.

parametresi joker karakteri destekler * . Birden çok depo belirtirseniz, tüm adlar joker karakteri içermelidir veya atlanmalıdır. Joker karakterlerle ve joker karakterler olmadan adların bir karışımını belirtemezsiniz.

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

-RequiredResource

Yüklenecek kaynakları belirten bir karma tablo veya JSON dizesi. Joker karakterlere izin verilmez. Dosya biçimlerinin açıklaması için NOTLAR bölümüne bakın.

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

-RequiredResourceFile

Yüklenecek kaynakları belirten veya .psd1 .json yolu. Joker karakterlere izin verilmez. Dosya biçimlerinin açıklaması için NOTLAR bölümüne bakın.

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

-Scope

Yükleme kapsamını belirtir. Kabul edilen değerler şunlardır:

  • CurrentUser
  • AllUsers

Varsayılan kapsam, yükleme için yükseltme gerektirmeyen şeklindedir CurrentUser.

Kapsam AllUsers , modülleri bilgisayarın tüm kullanıcıları tarafından erişilebilen bir konuma yükler. Örneğin:

  • $env:ProgramFiles\PowerShell\Modules

modüllerini CurrentUser yalnızca bilgisayarın geçerli kullanıcısı tarafından erişilebilen bir konuma yükler. Örneğin:

  • $home\Documents\PowerShell\Modules
Tür:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
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

-SkipDependencyCheck

Kaynak bağımlılıkları denetimini atlar. Yalnızca bulunan kaynaklar yüklenir. Bulunan kaynağın kaynakları yüklü değil.

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

-TemporaryPath

Gerçek yüklemeden önce kaynağın geçici olarak yükleneceği yolu belirtir. Geçici yol sağlanmamışsa, kaynak geçici olarak geçerli kullanıcının geçici klasörüne yüklenir.

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

-TrustRepository

Depoya güvenme istemlerini gizleme. Depoya güvenme istemi yalnızca depo güvenilir olarak yapılandırılmamışsa gerçekleşir.

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

-Version

Döndürülecek kaynağın sürümünü belirtir. Değer, NuGet sürüm oluşturma söz dizimini kullanarak tam bir sürüm veya sürüm aralığı olabilir.

NuGet sürüm aralıkları hakkında daha fazla bilgi için bkz . Paket sürümü oluşturma.

PowerShellGet, NuGet sürüm aralığı belgelerinde listelenen en düşük dahil sürüm dışında tüm sürümleri destekler. Sürüm olarak kullanmak 1.0.0.0 1.0.0.0 ve üzeri sürümleri (en düşük dahil aralık) vermez. Bunun yerine, değer gerekli sürüm olarak kabul edilir. En düşük kapsamlı aralığı aramak için sürüm aralığı olarak kullanın [1.0.0.0, ] .

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

-WhatIf

Cmdlet çalıştırılıyorsa ne olacağını gösterir. Cmdlet çalıştırılmıyor.

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

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Çıkışlar

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Varsayılan olarak, cmdlet hiçbir nesne döndürmez. PassThru parametresi kullanıldığında, cmdlet kaydedilen kaynak için bir PSResourceInfo nesnesi oluşturur.

Notlar

modülü için Install-PSResourcebir diğer ad olarak tanımlarisres.

RequiredResource ve RequiredResourceFile parametreleri, belirli ölçütlerle eşleşen PSResource nesnelerini bulmak için kullanılır. Arama ölçütlerini bir karma tablo veya JSON nesnesi kullanarak belirtebilirsiniz. RequiredResourceFile parametresi için hashtable bir .psd1 dosyada depolanır ve JSON nesnesi bir .json dosyada depolanır. Daha fazla bilgi için bkz . about_PSResourceGet.