Install-PSResource

Modül:

Microsoft.PowerShell.PSResourceGet Module

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

Syntax

NameParameterSet (Varsayılan)

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

InputObjectParameterSet

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

RequiredResourceFileParameterSet

Install-PSResource
    -RequiredResourceFile <String>
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RequiredResourceParameterSet

Install-PSResource
    -RequiredResource <Object>
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-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, Install-Module v2'den Install-Script ve cmdlet'lerinin işlevlerini 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.

Uyarı

Install-PSResource, NuGet v3 protokolunu kullanan depolardan bağımlı kaynakları yüklemez. Bağımlı kaynakları tek tek yüklemeniz gerekir. Bu özelliği gelecek bir sürüme eklemeyi planlıyoruz.

Örnekler

Örnek 1

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

Install-PSResource Az -Repository PSGallery

Az modülü, tüm Az PowerShell modüllerini bağımlılık olarak içeren bir meta modüldür. Bu komut Az modülünü ve tüm bağımlılıklarını yükler.

Örnek 2

ile 7.3.0arasındaki sürümler içinde en son kararlı 8.3.0 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 daha önce 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.

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

-AuthenticodeCheck

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

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

-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

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

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

-InputObject

İşlem hattı girişi için kullanılır.

Parametre özellikleri

Tür:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Ebeveyn Kaynağı

Parametre kümeleri

InputObjectParameterSet

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

-Name

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

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

-NoClobber

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

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

-PassThru

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

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

-Prerelease

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

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Yayın Öncesi

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

-Quiet

Yükleme ilerleme çubuğunu gizler.

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

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

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

-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 karakterini 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.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	True
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

InputObjectParameterSet

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

-RequiredResource

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

Parametre özellikleri

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

Parametre kümeleri

RequiredResourceParameterSet

Position:	Named
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

-RequiredResourceFile

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

Parametre özellikleri

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

Parametre kümeleri

RequiredResourceFileParameterSet

Position:	Named
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

-Scope

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

• CurrentUser
• AllUsers

Varsayılan kapsam, yükleme için yükseltme gerektirmeyen CurrentUser' dir.

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

• $env:ProgramFiles\PowerShell\Modules

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

• $home\Documents\PowerShell\Modules

Parametre özellikleri

Tür:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
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

-SkipDependencyCheck

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

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

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

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

-TrustRepository

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

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

-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 hariç tüm sürümleri destekler. sürüm olarak 1.0.0.0 kullanılması 1.0.0.0 ve üzeri sürümleri (en düşük kapsayıcı aralık) vermez. Bunun yerine, değer gerekli sürüm olarak kabul edilir. En düşük kapsayıcı aralığı aramak için sürüm aralığı olarak [1.0.0.0, ] kullanın.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	True
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

-WhatIf

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

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

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ü, isresInstall-PSResourceiçin bir diğer ad olarak tanımlar.

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 karma tablo bir .psd1 dosyasında ve JSON nesnesi .json bir dosyada depolanır. Daha fazla bilgi için bkz. about_PSResourceGet.

İlişkili Bağlantılar

• Paket sürümleme
• Uninstall-PSResource (PS Kaynağını Kaldır)