DSC PackageManagementSource erőforrás

Érintett kiadások: Windows PowerShell 4.0, Windows PowerShell 5.x

A Windows PowerShell Desired State Configuration (DSC) PackageManagementSource erőforrása egy mechanizmust biztosít a csomagkezelési források regisztrálásához vagy törléséhez a célcsomóponton. Az így regisztrált csomagkezelési források a rendszerkörnyezetben vannak regisztrálva, és a rendszerfiók vagy a DSC-motor használhatja. Ehhez az erőforráshoz a PowerShell-galéria elérhető PackageManagement modul szükséges.

Fontos

A PackageManagement modulnak legalább 1.1.7.0-s verziójúnak kell lennie ahhoz, hogy a következő tulajdonságadatok helyesek legyenek.

Megjegyzés

A DSC-erőforrás dokumentációja a PowerShell 7.2-es verzió előtti verzióját ismerteti. A PSDscResources modul a Microsoft által hivatalosan támogatott új és frissített DSC-erőforrásokat tartalmaz. A PSDscResources modul a PowerShell-galéria érhető el.

További információkért és a frissített dokumentációért tekintse meg a PSDscResources referenciadokumentációját.

Syntax

PackageManagementSource [String] #ResourceName
{
    Name = [string]
    ProviderName = [string]
    SourceLocation = [string]
    [ InstallationPolicy = [string]{ Trusted | Untrusted } ]
    [ SourceCredential = [PSCredential] ]
    [ DependsOn = [string[]] ]
    [ Ensure = [string]{ Absent | Present } ]
    [ PsDscRunAsCredential = [PSCredential] ]
}

Tulajdonságok

Tulajdonság	Leírás
Name (Név)	Megadja annak a csomagforrásnak a nevét, amelyet regisztrálni vagy törölni szeretne a rendszeren.
ProviderName	Megadja annak a OneGet-szolgáltatónak a nevét, amelyen keresztül együttműködhet a csomag forrásával.
SourceLocation	Megadja a csomagforrás URI-ját.
InstallationPolicy	Olyan szolgáltatók használják, mint a beépített Nuget-szolgáltató. Meghatározza, hogy megbízik-e a csomag forrásában. Az egyik: Nem megbízható vagy Megbízható.
SourceCredential	Hozzáférést biztosít a csomaghoz egy távoli forráson.

Közös tulajdonságok

Tulajdonság	Leírás
DependsOn	Azt jelzi, hogy egy másik erőforrás konfigurációjának futnia kell az erőforrás konfigurálása előtt. Ha például az először futtatni kívánt erőforrás-konfigurációs szkriptblokk azonosítója ResourceName, és a típusa ResourceType, akkor a tulajdonság használatának szintaxisa a következő DependsOn = "[ResourceType]ResourceName": .
Biztosítja	Meghatározza, hogy a csomagforrás regisztrálva vagy regisztráció nélkül legyen-e regisztrálva. Az alapértelmezett érték a Jelenik.
PsDscRunAsCredential	Beállítja a teljes erőforrás futtatásához szükséges hitelesítő adatokat.

Megjegyzés

A PsDscRunAsCredential közös tulajdonság hozzáadva a WMF 5.0-hoz, hogy bármely DSC-erőforrást más hitelesítő adatok kontextusában futtathasson. További információ: Hitelesítő adatok használata DSC-erőforrásokkal.

Példa

Ez a példa a csomagforrást https://nuget.org a PackageManagementSource DSC erőforrás használatával regisztrálja.

Configuration PackageManagementSourceTest
{
    Import-DscResource -ModuleName 'PackageManagement'

    PackageManagementSource SourceRepository
    {
        Ensure      = "Present"
        Name        = "MyNuget"
        ProviderName= "Nuget"
        SourceLocation   = "https://api.nuget.org/api/v3/"
        InstallationPolicy ="Trusted"
    }
}