Frissíthető súgó – áttekintés

Ez a dokumentum alapszintű bevezetést nyújt a PowerShell frissíthető súgó funkció kialakításába és működésébe. A modul szerzői és mások számára készült, akik Windows PowerShell súgótémakört küldő felhasználók számára.

Bevezetés

A PowerShell súgótémakörei a PowerShell-élmény szerves részét képezik. A PowerShell-modulokhoz hasonló módon a súgótémakört a szerzők és a PowerShell-felhasználók közösségének hozzájárulásai folyamatosan frissítik és fejlesztik.

A Windows PowerShell 3.0-ban bevezetett Frissíthető súgó funkció biztosítja, hogy a felhasználók a parancssorban a súgótémakörök legújabb verzióival, még a beépített PowerShell-parancsok esetében is, új modulok letöltése vagy a Windows Update futtatása nélkül is elérhetőek. A frissíthető súgó egyszerűvé teszi a frissítést azáltal, hogy parancsmagokat biztosít, amelyek letöltik a súgótémák legújabb verzióit az internetről, és a felhasználó helyi számítógépén a megfelelő alkönyvtárakba telepítik őket. Még azok a felhasználók is, akik tűzfal mögött vannak, az új parancsmagokkal frissített segítséget kaphatnak egy belső fájlmegosztástól.

A frissíthető súgót az Windows 8 Windows Server 2012 összes Windows PowerShell modulja teljes mértékben támogatja, és a funkciói az összes Windows PowerShell számára elérhetők. A frissíthető súgó csak XML-alapú súgófájlokat támogat. Nem támogatja a megjegyzésalapú súgót.

A frissíthető súgó a következő funkciókat tartalmazza.

• Az Update-Help parancsmag, amely meghatározza, hogy a felhasználók a modul legújabb súgófájlja-e, és ha nem, letölti a legújabb súgófájlokat az internetről, kicsomagolja őket, és telepíti őket a felhasználó számítógépén található megfelelő modul-alkönyvtárakba. A felhasználók a Get-Help parancsmag használatával azonnal megtekinthetik az újonnan telepített súgótémakört. Nem kell újraindítani a PowerShellt.

• A Save-Help parancsmag, amely letölti a legújabb súgófájlokat az internetről, és egy fájlrendszerkönyvtárba menti őket. A felhasználók a parancsmag használatával súgófájlokat kaphatnak a fájlrendszer könyvtárból, majd kicsomagolhatja és telepítheti őket a felhasználó számítógépének modul Update-Help alkönyvtárában. A parancsmagot olyan felhasználók számára tervezték, akik korlátozott vagy nem rendelkezik internet-hozzáféréssel, valamint olyan vállalatok számára, akik inkább korlátozzák Save-Help az internet-hozzáférést.

• Segítség egy modulhoz. A modulok súgófájljai egy egységként vannak kezelik és kézbesítik, így a felhasználók az összes súgófájlt leküldik az ő moduljukhoz. A frissíthető súgó csak modulokhoz támogatott, Windows PowerShell beépülő modulokhoz nem.

• Verziótámogatás. A frissíthető súgó standard négypozíciós (N1) pozíciót használ. N2. N3. N4) verziószámai. A frissíthető súgó akkor tölt le súgófájlokat, ha a súgófájlok verziószáma a felhasználó számítógépén (vagy a könyvtárban) alacsonyabb, mint a súgófájlok verziószáma az Save-Help interneten.

• Többnyelvű támogatás. A frissíthető súgó több felhasználói felületi kultúra modul súgófájljait is támogatja. A frissíthető súgófájlnevek olyan szabványos nyelvkódokat tartalmaznak, mint például az "en-US" és a "ja-JP", és a és parancsmagok a súgófájlokat a modulkönyvtár nyelvspecifikus alkönyvtáraiba Update-Help Save-Help foglalják.

• Automatikusan létrehozott súgó. A Get-Help parancsmag alapvető súgót jelenít meg azon parancsokhoz, amelyek nem tartalmaznak súgófájlokat. Az automatikusan generált súgó tartalmazza a parancs szintaxisát és aliasát, valamint az online súgó és a frissíthető súgó használatának utasításait.

• Továbbfejlesztett online súgó. Az online súgóhoz való egyszerű hozzáféréshez már nincs szükség súgófájlokra. A parancsmag Online paramétere mostantól le tudja kérni egy online súgótémakör URL-címét bármely parancs HelpUri tulajdonságának értékével, ha nem találja az online súgó Get-Help URL-címét egy súgófájlban. A HelpUri tulajdonság feltöltéséhez adja hozzá a HelpUri attribútumot a parancsmagok, függvények és CIM-parancsok kódhoz, vagy használja a parancsot. Megjegyzésalapú súgókra vonatkozó irányelv csatolása munkafolyamatokban és szkriptekben.

  A súgófájlok frissítésének érdekében a Windows 8 Windows PowerShell és Windows Server vNext moduljai nem tartalmaznak súgófájlokat. A felhasználók a Frissíthető súgó segítségével telepítheti és frissítheti a súgófájlokat. Más modulok szerzői súgófájlokat is tartalmazhatnak a modulokban, vagy kihagyhatják azokat. A frissíthető súgó támogatása nem kötelező, de ajánlott.