PowerShell DSC-bővítmény
Feljegyzés
A DSC-bővítmény engedélyezése előtt szeretnénk tudni, hogy a DSC egy újabb verziója általánosan elérhető, amelyet az Azure Automange nevű gépkonfiguráció egyik funkciója felügyel. A gépkonfigurációs funkció egyesíti a Desired State Configuration (DSC) bővítménykezelő, az Azure Automation State Configuration és az ügyfél visszajelzéseiből leggyakrabban kért funkciókat. A gépkonfiguráció az Arc-kompatibilis kiszolgálókon keresztüli hibrid géptámogatást is magában foglalja.
Áttekintés
A Windows PowerShell DSC-bővítményét a Microsoft teszi közzé és támogatja. A bővítmény feltölt és alkalmaz egy PowerShell DSC-konfigurációt egy Azure-beli virtuális gépen. A DSC-bővítmény meghívja a PowerShell DSC-t, hogy a kapott DSC-konfigurációt a virtuális gépen alakítsa ki. Ez a dokumentum a Windows DSC virtuálisgép-bővítményének támogatott platformjait, konfigurációit és üzembehelyezési lehetőségeit ismerteti.
Előfeltételek
Operációs rendszer
A DSC-bővítmény támogatja a következő operációs rendszer
Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012R2, Windows Server 2012, Windows Server 2008 R2 SP1, Windows Client 7/8.1/10
Internetkapcsolat
A Windows DSC-bővítménye megköveteli, hogy a cél virtuális gép kommunikálhasson az Azure-ral és a konfigurációs csomag helyével (.zip fájl), ha az Azure-on kívüli helyen van tárolva.
Bővítményséma
Az alábbi JSON egy Azure Resource Manager-sablonban a DSC-bővítmény beállítási részének sémáját mutatja be.
{
"type": "Microsoft.Compute/virtualMachines/extensions",
"name": "Microsoft.Powershell.DSC",
"apiVersion": "2018-10-01",
"location": "<location>",
"properties": {
"publisher": "Microsoft.Powershell",
"type": "DSC",
"typeHandlerVersion": "2.77",
"autoUpgradeMinorVersion": true,
"settings": {
"wmfVersion": "latest",
"configuration": {
"url": "http://validURLToConfigLocation",
"script": "ConfigurationScript.ps1",
"function": "ConfigurationFunction"
},
"configurationArguments": {
"argument1": "Value1",
"argument2": "Value2"
},
"configurationData": {
"url": "https://foo.psd1"
},
"privacy": {
"dataCollection": "enable"
},
"advancedOptions": {
"forcePullAndApply": false,
"downloadMappings": {
"specificDependencyKey": "https://myCustomDependencyLocation"
}
}
},
"protectedSettings": {
"configurationArguments": {
"parameterOfTypePSCredential1": {
"userName": "UsernameValue1",
"password": "PasswordValue1"
},
"parameterOfTypePSCredential2": {
"userName": "UsernameValue2",
"password": "PasswordValue2"
}
},
"configurationUrlSasToken": "?g!bber1sht0k3n",
"configurationDataUrlSasToken": "?dataAcC355T0k3N"
}
}
}
Tulajdonságértékek
| Név | Érték/ Példa | Adattípus |
|---|---|---|
| apiVersion | 2018-10-01 | dátum: |
| kiadó | Microsoft.Powershell.DSC | húr |
| típus | DSC | húr |
| typeHandlerVersion | 2.77 | egész |
Beállítások tulajdonságértékek
| Név | Adattípus | Leírás |
|---|---|---|
| settings.wmfVersion | húr | Megadja a windowsos felügyeleti keretrendszer azon verzióját, amelyet telepítenie kell a virtuális gépre. Ha ezt a tulajdonságot a "legújabb" értékre állítja, a WMF legújabb verzióját fogja telepíteni. Ennek a tulajdonságnak az egyetlen lehetséges értéke a "4.0", az "5.0" és a "legújabb". Ezek a lehetséges értékek frissítések tárgyát képezik. Az alapértelmezett érték a "legújabb". |
| settings.configuration.url | húr | Megadja azt az URL-címet, ahonnan le szeretné tölteni a DSC konfigurációs zip-fájlját. Ha a megadott URL-címhez SAS-jogkivonat szükséges a hozzáféréshez, a protectedSettings.configurationUrlSasToken tulajdonságot az SAS-jogkivonat értékére kell állítania. Ez a tulajdonság a settings.configuration.script és/vagy settings.configuration.function definiálásakor szükséges. |
| settings.configuration.script | húr | Megadja annak a szkriptnek a fájlnevét, amely tartalmazza a DSC-konfiguráció definícióját. Ennek a szkriptnek a configuration.url tulajdonság által megadott URL-címről letöltött zip-fájl gyökérmappájában kell lennie. Ez a tulajdonság a settings.configuration.url és/vagy settings.configuration.script definiálásához szükséges. |
| settings.configuration.function | húr | Megadja a DSC-konfiguráció nevét. A névvel ellátott konfigurációnak a configuration.script által definiált szkriptben kell lennie. Ez a tulajdonság akkor szükséges, ha a settings.configuration.url és/vagy a settings.configuration.function definiálva van. |
| settings.configurationArguments | Gyűjtemény | Meghatározza a DSC-konfigurációnak átadni kívánt paramétereket. Ez a tulajdonság nem lesz titkosítva. |
| settings.configurationData.url | húr | Megadja azt az URL-címet, amelyről le szeretné tölteni a konfigurációs adatokat (.pds1) a DSC-konfiguráció bemeneteként használni. Ha a megadott URL-címhez SAS-jogkivonat szükséges a hozzáféréshez, a protectedSettings.configurationDataUrlSasToken tulajdonságot az SAS-jogkivonat értékére kell állítania. |
| settings.privacy.dataEnabled | húr | Engedélyezi vagy letiltja a telemetriai gyűjteményt. Ennek a tulajdonságnak az egyetlen lehetséges értéke az "Engedélyezés", a "Letiltás", a "vagy a $null. Ha ezt a tulajdonságot üresen vagy null értékként hagyja, akkor a telemetriai adatok engedélyezve lesznek |
| settings.advancedOptions.forcePullAndApply | Bool | Ez a beállítás a csomópontok Azure Automation DSC-vel való regisztrálására szolgáló bővítmény használatának élményét hivatott fokozni. Ha az érték az $true, a bővítmény megvárja a szolgáltatásból lekért konfiguráció első futtatását, mielőtt sikert/hibát adna vissza. Ha az érték $false értékre van állítva, a bővítmény által visszaadott állapot csak arra vonatkozik, hogy a csomópont sikeresen regisztrálva lett-e az Azure Automation State Configuration szolgáltatásban, és a csomópont konfigurációja nem lesz futtatva a regisztráció során. |
| settings.advancedOptions.downloadMappings | Gyűjtemény | Alternatív helyeket határoz meg olyan függőségek letöltéséhez, mint a WMF és a .NET |
Védett beállítások tulajdonságértékek
| Név | Adattípus | Leírás |
|---|---|---|
| protectedSettings.configurationArguments | húr | Meghatározza a DSC-konfigurációnak átadni kívánt paramétereket. Ez a tulajdonság titkosítva lesz. |
| protectedSettings.configurationUrlSasToken | húr | Megadja a configuration.url által meghatározott URL-címet elérő SAS-jogkivonatot. Ez a tulajdonság titkosítva lesz. |
| protectedSettings.configurationDataUrlSasToken | húr | A configurationData.url által meghatározott URL-cím eléréséhez szükséges SAS-jogkivonatot adja meg. Ez a tulajdonság titkosítva lesz. |
Sablonalapú telepítés
Az Azure-beli virtuálisgép-bővítmények Azure Resource Manager-sablonokkal telepíthetők. A sablonok ideálisak egy vagy több olyan virtuális gép üzembe helyezésekor, amely az üzembe helyezés utáni konfigurációt igényli. A Windows DSC-bővítményét tartalmazó Resource Manager-mintasablon az Azure Gyors üzembe helyezési gyűjteményében található.
Hibaelhárítás és támogatás
Hibaelhárítás
A bővítmények üzembe helyezésének állapotára vonatkozó adatok lekérhetők az Azure Portalról és az Azure CLI használatával. Egy adott virtuális gép bővítményeinek üzembehelyezési állapotának megtekintéséhez futtassa az alábbi parancsot az Azure CLI használatával.
az vm extension list --resource-group myResourceGroup --vm-name myVM -o table
A bővítménycsomag letöltése és üzembe helyezése erre a helyre történik az Azure-beli virtuális gépen
C:\Packages\Plugins\{Extension_Name}\{Extension_Version}
A bővítmény állapotfájlja tartalmazza az alállapotot és a sikerre/hibára utaló állapotkódokat, valamint az egyes futtatott bővítmények részletes hibaüzenetét és leírását.
C:\Packages\Plugins\{Extension_Name}\{Extension_Version}\Status\{0}.Status -> {0} being the sequence number
A bővítmény kimeneti naplói a következő könyvárban vannak naplózva:
C:\WindowsAzure\Logs\Plugins\{Extension_Name}\{Extension_Version}
Hibakódok és jelentésük
| Hibakód | Értelmezés | Lehetséges művelet |
|---|---|---|
| 1000 | Általános hiba | Ennek a hibának az üzenetét a bővítménynaplókban megadott kivétel adja meg |
| 52 | Bővítménytelepítési hiba | A hiba üzenetét az adott kivétel adja meg |
| 1002 | Wmf telepítési hiba | Hiba történt a WMF telepítése során. |
| 1004 | Érvénytelen zip-csomag | Érvénytelen zip ; Hiba történt a zip kicsomagolása közben |
| 1100 | Argumentumhiba | A felhasználó által megadott bemenettel kapcsolatos problémát jelez. A hiba üzenetét az adott kivétel adja meg |
Támogatás
Ha a cikk bármely pontján további segítségre van szüksége, forduljon az Azure szakértőihez az MSDN Azure és a Stack Overflow fórumain. Másik lehetőségként Azure-támogatás incidenst is beszedhet. Lépjen a Azure-támogatás webhelyre, és válassza a Támogatás kérése lehetőséget. Az Azure-támogatás használatáról a Microsoft Azure-támogatás GYIK-ben talál további információt.