DSC-csomag erőforrása
A következőkre vonatkozik: Windows PowerShell 4.0, Windows PowerShell 5.x
A Windows PowerShell Desired State Configuration csomagerőforrása (DSC) egy olyan mechanizmust biztosít, amely lehetővé teszi a csomagok, például a Windows Installer és a setup.exe csomagok telepítését vagy eltávolítását egy célcsomóponton.
Megjegyzés
A DSC-erőforrás dokumentációja a PowerShell 7.2-es verzió előtti verzióját tartalmazza. A PSDscResources modul a Microsoft által hivatalosan támogatott új és frissített DSC-erőforrásokat tartalmaz. A PSDscResources modul elérhető a PowerShell-galéria.
További információkért és a frissített dokumentációért tekintse meg a PSDscResources referenciadokumentációját.
Syntax
Package [string] #ResourceName
{
Name = [string]
Path = [string]
ProductId = [string]
[ Arguments = [string] ]
[ Credential = [PSCredential] ]
[ LogPath = [string] ]
[ ReturnCode = [UInt32[]] ]
[ DependsOn = [string[]] ]
[ Ensure = [string] { Absent | Present } ]
[ PsDscRunAsCredential = [PSCredential] ]
}
Tulajdonságok
Tulajdonság | Leírás |
---|---|
Name (Név) | Annak a csomagnak a nevét jelzi, amelyhez egy adott állapotot szeretne biztosítani. |
Elérési út | A csomag elérési útját jelzi. |
ProductId | Azt a termékazonosítót jelöli, amely egyedileg azonosítja a csomagot. |
Argumentumok | Az argumentumok sztringje, amelyet a rendszer pontosan a megadott módon ad át a csomagnak. |
Hitelesítő adat | Hozzáférést biztosít a csomaghoz egy távoli forráson. Ez a tulajdonság nem használható a csomag telepítéséhez. A csomag mindig telepítve van a helyi rendszeren. |
LogPath | Azt a teljes elérési utat jelzi, ahová a szolgáltató menteni szeretné a naplófájlt a csomag telepítéséhez vagy eltávolításához. |
ReturnCode | A várt visszatérési kódot jelzi. Ha a tényleges visszatérési kód nem egyezik meg az itt megadott várt értékkel, a konfiguráció hibát ad vissza. |
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 típusa ResourceType, akkor a tulajdonság használatának szintaxisa a DependsOn = "[ResourceType]ResourceName" következő: . |
Biztosítja | Azt jelzi, hogy a csomag telepítve van-e. Állítsa ezt a tulajdonságot a Hiányzó értékre, és győződjön meg arról, hogy a csomag nincs telepítve (vagy ha telepítve van, távolítsa el a csomagot). Állítsa a Present értékre a csomag telepítésének ellenőrzéséhez. Az alapértelmezett érték a Jelen. |
PsDscRunAsCredential | Beállítja a hitelesítő adatokat a teljes erőforrás futtatásához. |
Megjegyzés
A PsDscRunAsCredential common tulajdonság hozzá lett adva a WMF 5.0-s verziójához, hogy bármely DSC-erőforrást más hitelesítő adatokkal összefüggésben futtathasson. További információ: Hitelesítő adatok használata DSC-erőforrásokkal.
Példa
Ez a példa a megadott útvonalon található .msi telepítőt futtatja, és a megadott termékazonosítóval rendelkezik.
Configuration PackageTest
{
Import-DscResource -ModuleName 'PSDesiredStateConfiguration'
Package PackageExample
{
Ensure = "Present" # You can also set Ensure to "Absent"
Path = "$Env:SystemDrive\TestFolder\TestProject.msi"
Name = "TestPackage"
ProductId = "ACDDCDAF-80C6-41E6-A1B9-8ABD8A05027E"
}
}
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: