Hozzon létre, és a PowerShell-szkriptek futtatása a Configuration Manager konzolrólCreate and run PowerShell scripts from the Configuration Manager console

Vonatkozik: A System Center Configuration Manager (aktuális ág)Applies to: System Center Configuration Manager (Current Branch)

System Center Configuration Managerben, és egy beépített Powershell-parancsfájlok futtatását. System Center Configuration Manager has an integrated ability to run Powershell scripts. PowerShell az előnye, hogy kifinomult létrehozása, megértettem és a egy Közösség megosztott automatizált parancsfájlokat rendelkezik.Powershell has the benefit of creating sophisticated, automated scripts that are understood and shared with a larger community. A parancsfájlok egyszerűbb egyéni eszközök felügyeletéhez a szoftvert, és lehetővé teszik, hétköznapi feladatok elvégzését, így egyszerűen több, konzisztens módon több nagy méretű feladatok beolvasása.The scripts simplify building custom tools to administer software and let you accomplish mundane tasks quickly, allowing you to get large jobs done more easily and more consistently.

Tipp

Ez a funkció 1706-os verzió, rendszerben bevezetett egy kiadás előtti funkció.This feature was first introduced in version 1706 as a pre-release feature. Az 1802-es verzió kezdve ez a funkció már nem előzetes funkciókat.Beginning with version 1802, this feature is no longer a pre-release feature.

Megjegyzés

A Configuration Manager alapértelmezés szerint nem engedélyezi ezt a választható funkciót.Configuration Manager doesn't enable this optional feature by default. Használat előtt engedélyeznie kell ezt a szolgáltatást.You must enable this feature before using it. További információkért lásd: a frissítések választható funkcióinak engedélyezése.For more information, see Enable optional features from updates.

Ez az integráció a System Center Configuration Managerben, használhatja a parancsfájlok futtatása funkciókat tegye a következőket:With this integration in System Center Configuration Manager, you can use the Run Scripts functionality to do the following things:

  • Hozzon létre, és szerkessze a parancsfájlok használata a System Center Configuration Managerrel.Create and edit scripts for use with System Center Configuration Manager.
  • Parancsfájl-használat szerepkörök és biztonsági hatókörök kezelése.Manage script usage through roles and security scopes.
  • Parancsfájlok futtathatók gyűjteményeket vagy egyedi a helyszínen felügyelt Windows rendszerű számítógépek.Run scripts on collections or individual on-premises managed Windows PCs.
  • Gyors összesített szkript eredményeinek beolvasása az ügyféleszközökön.Get rapid aggregated script results from client devices.
  • Figyelheti a parancsfájl végrehajtása, és -parancsfájl kimenetében jelentéskészítési eredmények megtekintése.Monitor script execution and view reporting results from script output.

Figyelmeztetés

Adja meg a teljesítmény-szkriptek, hogy emlékeztesse a szándékos és a használatuk körültekintően kell.Given the power of scripts, we remind you to be intentional and careful with their usage. Mi építettünk szabályozzuk, amely segítséget nyújt; a elkülönített szerepkörök és hatókörök.We have built in additional safeguards to assist you; segregated roles and scopes. Mindenképpen ellenőrizze a parancsfájlok pontosságát őket futtatása előtt, és győződjön meg arról, hogy nem kívánt parancsfájl végrehajtása egy megbízható forrásból származnak.Be sure to validate the accuracy of scripts before running them and confirm they are from a trusted source, to prevent unintended script execution. Fordítson kiterjesztett karaktereket vagy más rejtjelezésre utaló jeleket, és tájékoztassa saját kezűleg parancsfájlok védelmével kapcsolatos.Be mindful of extended characters or other obfuscation and educate yourself about securing scripts. További tudnivalók a PowerShell-parancsfájlok biztonságánakLearn more about PowerShell script security

ElőfeltételekPrerequisites

  • PowerShell-parancsfájlok futtatását, az ügyfél kell futnia verzió PowerShell 3.0-s vagy újabb.To run PowerShell scripts, the client must be running PowerShell version 3.0 or later. Azonban ha a parancsfájl futtatása egy újabb verziójának PowerShell funkciói tartalmaz, az ügyfélnek, amelyen a szkript futtatása futnia kell a PowerShell-verzió.However, if a script you run contains functionality from a later version of PowerShell, the client on which you run the script must be running that version of PowerShell.
  • Configuration Manager-ügyfelek futnia kell az ügyfél az 1706-os kiadáshoz, vagy később a parancsfájlok futtatásához.Configuration Manager clients must be running the client from the 1706 release, or later in order to run scripts.
  • Parancsfájlok használata a Configuration Manager megfelelő biztonsági szerepkör tagjának kell lennie.To use scripts, you must be a member of the appropriate Configuration Manager security role.
  • Importálhatja és - parancsfájlok készítése a fióknak rendelkeznie kell létrehozás engedélyeinek SMS-szkriptek.To import and author scripts - Your account must have Create permissions for SMS Scripts.
  • Jóváhagyja vagy elutasítja a parancsfájlok – a fióknak rendelkeznie kell jóváhagyás engedélyeinek SMS-szkriptek.To approve or deny scripts - Your account must have Approve permissions for SMS Scripts.
  • -Szkriptek futtatásához a fióknak rendelkeznie kell parancsfájl futtatása engedélyeinek gyűjtemények.To run scripts - Your account must have Run Script permissions for Collections.

További információ a Configuration Manager biztonsági szerepkörök:For more information about Configuration Manager security roles:
Biztonsági hatókörök parancsprogramok futtatásaSecurity scopes for run scripts
Biztonsági szerepkörök parancsprogramok futtatásaSecurity roles for run scripts
Szerepköralapú Adminisztráció alapjai.Fundamentals of role-based administration.

KorlátozásokLimitations

Futtatási parancsfájlok jelenleg támogatja:Run Scripts currently supports:

  • Programozási nyelvek: PowerShellScripting languages: PowerShell
  • Paraméter típusa: egész szám, karakterlánc és listáját.Parameter types: integer, string, and list.

Figyelmeztetés

Vegye figyelembe, hogy amikor paraméterekkel, megnyílik a potenciális PowerShell injektálási támadások kockázat terület.Be aware that when using parameters, it opens a surface area for potential PowerShell injection attack risk. Számos különféle módon csökkentheti, és megoldása, például a reguláris kifejezések használata a paraméter bemeneti ellenőrzése, vagy használja az előre meghatározott paraméterek.There are various ways to mitigate and work around, such as using regular expressions to validate parameter input or using predefined parameters. Általános ajánlott eljárás a beállítás titkos kulcsokat (nincs jelszavak, stb.) a PowerShell-szkriptek a alkalmazni.Common best practice is not to include to secrets in your PowerShell scripts (no passwords, etc.). További tudnivalók a PowerShell-parancsfájlok biztonságának Learn more about PowerShell script security

Futtatási szkriptkészítők és a jóváhagyóknakRun Script authors and approvers

Futtassa a parancsfájlokat használ a fogalmát szerzők parancsfájl és jóváhagyók parancsfájl külön szerepkörökként végrehajtása és a egy szkriptet.Run Scripts uses the concept of script authors and script approvers as separate roles for implementation and execution of a script. A szerző és a jóváhagyó szerepkör elválasztott lehetővé, hogy egy fontos folyamat, ellenőrizze a hatékony eszköz, amely parancsfájlok futtatása.Having the author and approver roles separated allows for an important process check for the powerful tool that Run Scripts is. Van egy további indák parancsfájl szerepkör, amely lehetővé teszi, hogy a parancsfájlok, de nem létrehozása végrehajtásának vagy parancsfájlok jóváhagyását.There is an additional script runners role that allows execution of scripts, but not creation or approval of scripts. Lásd: parancsprogramok biztonsági szerepkörök létrehozása.See Create security roles for scripts.

Parancsfájlok szerepkörök vezérlőScripts roles control

Alapértelmezés szerint a felhasználó nem hagyhatja jóvá egy szkriptet, akkor hozták létre.By default, users cannot approve a script they have authored. Mivel a parancsfájlok, nagy teljesítményű, sokoldalú és potenciálisan sok eszköz telepítve, a szerepkörök között a személy, amely hoznak létre a parancsfájlt, és a személy, amely elfogadja a parancsfájl elkülönítheti a.Because scripts are powerful, versatile, and potentially deployed to many devices, you can separate the roles between the person that authors the script and the person that approves the script. Ezek a szerepkörök adjon egy újabb szintjét biztonsági felügyelet nélküli parancsfájl futtatása ellen.These roles give an additional level of security against running a script without oversight. Másodlagos jóváhagyási tesztelése a könnyű kikapcsolása érvényesülnek.You are able to turn off secondary approval, for ease of testing.

A szkript jóváhagyása vagy elutasításaApprove or Deny a script

Parancsfájlok jóvá kell hagyni, a a jóváhagyó parancsfájl szerepkört, előtt futtathatók.Scripts must be approved, by the script approver role, before they can be run. A szkript jóváhagyása:To approve a script:

  1. A Configuration Manager konzolon kattintson a Szoftverkönyvtárelemre.In the Configuration Manager console, click Software Library.
  2. Az a szoftverkönyvtár munkaterületen kattintson a parancsfájlok.In the Software Library workspace, click Scripts.
  3. Az a parancsfájl menüben válassza ki a jóváhagyni vagy elutasítani kívánt parancsfájlt, majd a a kezdőlap lap a parancsfájl csoportjában kattintson a jóváhagyás/Deny.In the Script list, choose the script you want to approve or deny and then, on the Home tab, in the Script group, click Approve/Deny.
  4. Az a jóváhagyás szkript vagy elutasítása párbeszédpanelen jelölje ki jóváhagyás, vagy Megtagadás a szkript esetében.In the Approve or deny script dialog box, select Approve, or Deny for the script. Megadhatja a döntést kapcsolatos megjegyzéseit.Optionally, enter a comment about your decision. A parancsfájl megtagadja, akkor azt nem lehet futtatni az ügyféleszközökön.If you deny a script, it cannot be run on client devices.
    Parancsfájl - jóváhagyásScript - Approval
  5. Fejezze be a varázslót.Complete the wizard. Az a parancsfájl listában megjelenik a jóváhagyási állapot függően a művelet oszlop módosítása.In the Script list, you see the Approval State column change depending on the action you took.

Hogy a felhasználók saját szkriptjeiket jóváhagyásaAllow users to approve their own scripts

Ez a jóváhagyás elsősorban a fejlesztési parancsfájl tesztelési fázisához.This approval is primarily used for the testing phase of script development.

  1. A Configuration Manager konzolon kattintson az Adminisztrációelemre.In the Configuration Manager console, click Administration.
  2. Az Adminisztráció munkaterületen bontsa ki a Helykonfigurációcsomópontot, majd kattintson a Helyekelemre.In the Administration workspace, expand Site Configuration, and then click Sites.
  3. A listán, válassza ki a webhely, majd a a kezdőlap lap a helyek csoportjában kattintson a Hierarchiabeállítások.In the list of sites, choose your site and then, on the Home tab, in the Sites group, click Hierarchy Settings.
  4. Az a általános lapján a Hierarchiabeállítások tulajdonságai párbeszédpanel mezőben, a jelölőnégyzet jelének szkriptkészítők további szkriptjóváhagyó szükséges.On the General tab of the Hierarchy Settings Properties dialog box, clear the checkbox Script authors require additional script approver.

Fontos

Ajánlott eljárásként nem engedélyezi a saját szkriptjeiket jóváhagyása egy parancsfájlt a szerzője.As a best practice, you shouldn't allow a script author to approve their own scripts. Csak engedhető laboratóriumban.It should only be allowed in a lab setting. Alaposan gondolja át az áttelepítési fázis lehetséges hatásainak módosítja ezt a beállítást, az éles környezetben.Carefully consider the potential impact of changing this setting in a production environment.

Biztonsági hatókörökSecurity scopes

(Amely az 1710-es verzió)(Introduced with version 1710)
A Futtatás parancsfájlokat használ biztonsági hatóköröket, egy meglévő Configuration Manager szolgáltatás ellenőrzési parancsfájlok készítése és címkék, amelyek a felhasználói csoportok hozzárendelése keresztüli végrehajtást.Run Scripts uses security scopes, an existing feature of Configuration Manager, to control scripts authoring and execution through assigning tags that represent user groups. Biztonsági hatókörök használatával kapcsolatos további információkért lásd: szerepkör alapú felügyelet a System Center Configuration Manager konfigurálása.For more information on using security scopes, see Configure role-based administration for System Center Configuration Manager.

Parancsprogramok biztonsági szerepkörök létrehozásaCreate security roles for scripts

A Configuration Manager alapértelmezés szerint nem jönnek létre a parancsfájlok futtatásához használt három biztonsági szerepköröket.The three security roles used for running scripts are not created by default in Configuration Manager. A parancsfájl indák szkriptkészítők és parancsfájl jóváhagyók szerepkörök létrehozásához kövesse a fenti lépéseket.To create the script runners, script authors, and script approvers roles, follow the outlined steps.

  1. A Configuration Manager konzolon lépjen a felügyeleti >biztonsági >biztonsági szerepkörökIn the Configuration Manager console, go to Administration >Security >Security Roles
  2. Kattintson a jobb gombbal egy szerepkört, és kattintson másolási.Right-click on a role and click Copy. Másolja a szerepkör jogosult már hozzá van rendelve.The role you copy has permissions already assigned. Győződjön meg arról is, hogy csak a kívánt engedélyekkel.Make sure you take only the permissions that you want.
  3. Adjon meg egyéni egy neve és a egy leírás.Give the custom role a Name and a Description.
  4. A biztonsági szerepkör az alábbi engedélyek hozzárendelése.Assign the security role the permissions outlined below.

Biztonsági szerepkör engedélyeiSecurity Role Permissions

Szerepkör neve: Parancsfájl indákRole Name: Script Runners

  • Leírás: Ezeket az engedélyeket ehhez a szerepkörhöz, csak a korábban létrehozott és más szerepkörök által jóváhagyott szkriptek futtatását engedélyezi.Description: These permissions enable this role to only run scripts that were previously created and approved by other roles.
  • Engedélyek: Győződjön meg arról, a következő vannak beállítva, hogy Igen.Permissions: Ensure the following are set to Yes.
KategóriaCategory EngedélyPermission ÁllapotState
GyűjteményCollection Parancsfájl futtatásaRun Script IgenYes
HelySite Olvassa elRead IgenYes
SMS-szkriptekSMS Scripts Hozzon létreCreate IgenYes
SMS-szkriptekSMS Scripts Olvassa elRead IgenYes

Szerepkör neve: SzkriptkészítőkRole Name: Script Authors

  • Leírás: Ezek az engedélyek engedélyezése ehhez a szerepkörhöz, Szerző és parancsfájlok, de nem hagyja jóvá vagy futtathatja őket.Description: These permissions enable this role to author scripts, but they can’t approve or run them.
  • Engedélyek: Győződjön meg arról, a következő engedélyek vannak beállítva.Permissions: Ensure the following permissions are set.
KategóriaCategory EngedélyPermission ÁllapotState
GyűjteményCollection Parancsfájl futtatásaRun Script NemNo
HelySite Olvassa elRead IgenYes
SMS-szkriptekSMS Scripts Hozzon létreCreate IgenYes
SMS-szkriptekSMS Scripts Olvassa elRead IgenYes
SMS-szkriptekSMS Scripts TörlésDelete IgenYes
SMS-szkriptekSMS Scripts MódosításModify IgenYes

Szerepkör neve: Parancsfájl jóváhagyókRole Name: Script Approvers

  • Leírás: Ezek az engedélyek engedélyezése ehhez a szerepkörhöz parancsfájlok jóváhagyása, de azok nem hozható létre, vagy futtathatja őket.Description: These permissions enable this role to approve scripts, but they can’t create or run them.
  • Engedélyek: Győződjön meg arról, a következő engedélyek vannak beállítva.Permissions: Ensure the following permissions are set.
KategóriaCategory EngedélyPermission ÁllapotState
GyűjteményCollection Parancsfájl futtatásaRun Script NemNo
HelySite Olvassa elRead IgenYes
SMS-szkriptekSMS Scripts Olvassa elRead IgenYes
SMS-szkriptekSMS Scripts Hagyja jóváApprove IgenYes
SMS-szkriptekSMS Scripts MódosításModify IgenYes

SMS-szkriptek engedély parancsfájl szerzők – példaExample of SMS Scripts permissions for the script authors role

SMS-szkriptek engedély parancsfájl szerzők – példa

Parancsfájl létrehozásaCreate a script

  1. A Configuration Manager konzolon kattintson a Szoftverkönyvtárelemre.In the Configuration Manager console, click Software Library.
  2. Az a szoftverkönyvtár munkaterületen kattintson a parancsfájlok.In the Software Library workspace, click Scripts.
  3. Az a kezdőlap lap a létrehozás csoportjában kattintson a parancsfájl létrehozása.On the Home tab, in the Create group, click Create Script.
  4. Az a parancsfájl létrehozása lapján parancsfájl varázslóban adja meg a következő beállításokat:On the Script page of the Create Script wizard, configure the following settings:
    • Szkript neve – adja meg a parancsfájl nevét.Script Name - Enter a name for the script. Ezzel a névvel több parancsfájlt is hozhat létre, ismétlődő nevek használata megnehezíti, hogy a Configuration Manager konzolon keresse meg a parancsfájl van szüksége.Although you can create multiple scripts with the same name, using duplicate names makes it harder for you to find the script you need in the Configuration Manager console.
    • Snyelv – jelenleg csak a PowerShell-parancsfájlok használata támogatott.Script language - Currently, only PowerShell scripts are supported.
    • Importálás – egy PowerShell-parancsprogram importálja a konzolon.Import - Import a PowerShell script into the console. A parancsfájl jelenik meg a parancsfájl mező.The script is displayed in the Script field.
    • Egyértelmű – eltávolítja a jelenlegi parancsfájlt a parancsfájl mező.Clear - Removes the current script from the Script field.
    • Parancsfájl – megjeleníti az éppen importált parancsfájlt.Script - Displays the currently imported script. A parancsfájl ebben a mezőben, szükség szerint szerkesztheti.You can edit the script in this field as necessary.
  5. Fejezze be a varázslót.Complete the wizard. Az új parancsfájl jelenik meg a parancsfájl állapottal a listában jóváhagyásra váró.The new script is displayed in the Script list with a status of Waiting for approval. Ez a szkript futtatásához az ügyféleszközökön, jóvá kell hagynia.Before you can run this script on client devices, you must approve it.

Fontos

Kerülje a parancsfájl-kezelési eszköz-újraindítás vagy a Configuration Manager-ügynököt újra kell indítani a parancsfájlok futtatása funkció használatakor.Avoid scripting a device reboot or a restart of the Configuration Manager agent when using the Run Scripts feature. Ezzel folyamatos éppen újraindul állapotba vezethet.Doing so could lead to a continuous rebooting state. Szükség esetén vannak webhelyszolgáltatásokkal kapcsolatos fejlesztéseket tartalmaz az ügyfél-értesítési szolgáltatás, amelyek lehetővé teszik az újraindítás eszközök, az 1710-es verziója a Configuration Manager indítása.If needed, there are enhancements to the client notification feature that enable restarting devices, starting in Configuration Manager version 1710. A függőben lévő újraindítás oszlop segítségével azonosítható, eszközök, újraindítás szükséges.The pending restart column can help identify devices that need a restart.

SzkriptparaméterekScript parameters

(Amely az 1710-es verzió)(Introduced with version 1710)
A munka nagyobb rugalmasság-paramétereket adunk hozzá egy parancsfájlhoz biztosít.Adding parameters to a script provides increased flexibility for your work. A következő ismerteti a parancsfájlok futtatásához a szolgáltatás jelenlegi képesség a parancsfájl paramétereit; Karakterlánc, egész adattípusokat.The following outlines the Run Scripts feature's current capability with script parameters for; String, Integer data types. Előre definiált értékek listája is elérhetők.Lists of preset values are also available. Ha a parancsfájl nem támogatott adattípusok, egy figyelmeztetés jelenik meg.If your script has unsupported data types, you get a warning.

Az a parancsfájl létrehozása párbeszédpanelen kattintson a Szkriptparaméterek alatt parancsfájl.In the Create Script dialog, click Script Parameters under Script.

A parancsfájl paramétereit mindegyike rendelkezik a saját adatait és érvényesítési hozzáadása párbeszédpanel.Each of your script's parameters has its own dialog for adding further details and validation.

Fontos

Paraméter értéke nem tartalmazhat aposztrófot.Parameter values can't contain an apostrophe.
Egy ismert probléma van a Configuration Manager verziója 1802 ahol szóközöket a paraméterek nem átadva a parancsfájl megfelelően.There is a known issue in Configuration Manager version 1802 where parameters with spaces don't get passed to the script properly. Adható meg a paraméter használata esetén csak az első elem a paraméterben átadott a parancsfájl, és mindent után a hely nem átadott.If a space is used in the parameter, only the first item in the parameter is passed to the script and everything after the space is not passed. Rendszergazdák ezt a problémát úgy is parancsfájlt, és cserélje le a tárolóhelyek helyettesítő karaktert, és konvertálja azokat, vagy más módszerrel.Admins can script around this by substituting alternate characters for spaces and converting them, or with other methods.

Paraméter ellenőrzéseParameter validation

Minden paraméternek a parancsfájl egy Szkriptparaméter tulajdonságai párbeszédpanelen is hozzáadhat az érvényesítési arra a paraméterre vonatkozóan.Each parameter in your script has a Script Parameter Properties dialog for you to add validation for that parameter. Érvényesítési felvett hibák felvételekor egy értéket a paraméter, amely nem felel meg a hozzá tartozó érvényesítési szerezheti be.After adding validation, you should get errors if you are entering a value for a parameter that does not meet its validation.

Például: KeresztnévExample: FirstName

Ebben a példában is tudja a karakterlánc-paraméter tulajdonságainak beállításához FirstName.In this example, you are able to set the properties of the string parameter, FirstName.

Szkriptparaméterek - karakterlánc

Az érvényesítés szakaszában a Szkriptparaméter tulajdonságai párbeszédpanel használható a következő mezőket tartalmazza:The validation section of the Script Parameter Properties dialog contains the following fields for your use:

  • Minimális hossz – legalább hány karakterből kell állnia, a FirstName mező.Minimum Length - minimum number of characters of the FirstName field.
  • Maximális hossz– legfeljebb hány karakterből kell állnia, a FirstName mezőMaximum Length- maximum number of characters of the FirstName field
  • RegEx – rövid a reguláris kifejezés.RegEx - short for Regular Expression. A reguláris kifejezés használatával további információkért tekintse meg a következő szakaszban reguláris kifejezés használatával érvényesítési.For more information on using the Regular Expression, see the next section, Using Regular Expression validation.
  • Egyéni hiba – hasznos, ha a saját egyéni hibaüzenet, amely felülírja a rendszer érvényesítési hibaüzeneteket.Custom Error - useful for adding your own custom error message that supersedes any system validation error messages.

Reguláris kifejezés érvényesítés használatávalUsing Regular Expression validation

Reguláris kifejezés olyan programozási ellenőrzéséhez egy karakterlánc-kódolású érvényesítési ellen, compact típusú.A regular expression is a compact form of programming for checking a string of characters against an encoded validation. Például sikerült keresése a befektetési betűt hiányában a FirstName mezőt elhelyezésével [^A-Z] a a RegEx mező.For example, you could check for the absence of a capital alphabetic character in the FirstName field by placing [^A-Z] in the RegEx field.

A reguláris kifejezés feldolgozása ezen a párbeszédpanelen a .NET-keretrendszert támogatja.The regular expression processing for this dialog is supported by the .NET Framework. Reguláris kifejezések használatával kapcsolatos útmutatóért lásd: .NET reguláris kifejezés.For guidance on using regular expressions, see .NET Regular Expression.

PéldaszkriptekScript examples

Az alábbiakban néhány példa erre, amelyek megmutatják, parancsfájlok, akkor érdemes használni ezt a funkciót.Here are a couple examples that illustrate scripts you might want to use with this capability.

Hozzon létre egy új mappa és fájlCreate a new folder and file

Ez a szkript létrehoz egy új mappát, és a egy fájlt a mappába, az elnevezési bemenet megadva.This script creates a new folder and a file within the folder, given your naming input.

Param(
[Parameter(Mandatory=$True)]
[string]$FolderName,
[Parameter(Mandatory=$True)]
[string]$FileName
)

New-Item $FolderName -type directory
New-Item $FileName -type file

Operációsrendszer-verzió beolvasásaGet OS Version

A szkript a gépet az operációsrendszer-verzió lekérdezéséhez WMI használja.This script uses WMI to query the machine for its OS version.

Write-Output (Get-WmiObject -Class Win32_operatingSystem).Caption

Parancsfájl futtatásaRun a script

Miután a parancsfájl jóváhagyják, akkor futtatható egy adott eszköz vagy egy gyűjtemény.After a script is approved, it can be run against a single device or a collection. A parancsfájl végrehajtásának megkezdése után a azt indítható gyorsan egy magas prioritású rendszer, amely egy óra alatt időtúllépés következik.Once execution of your script begins, it is launched quickly through a high priority system that times-out in one hour. A szkript eredményeinek majd vissza egy állapotüzenet-rendszer használatával.The results of the script are then returned using a state message system.

A szkript célértékei gyűjteménye kiválasztása:To select a collection of targets for your script:

  1. Kattintson a Configuration Manager-konzolon az Eszközök és megfelelőségelemre.In the Configuration Manager console, click Assets and Compliance.
  2. Az eszközök és megfelelőség munkaterületen kattintson a Eszközgyűjtemények.In the Assets and Compliance workspace, click Device Collections.
  3. Az a Eszközgyűjtemények listában, kattintson arra a gyűjteményre, amelyen a parancsfájl futtatásához kívánt eszközöket.In the Device Collections list, click the collection of devices on which you want to run the script.
  4. Válasszon ki egy gyűjteményt a választott, kattintson a parancsfájl futtatása.Select a collection of your choice, click Run Script.
  5. Az a parancsfájl lapján a parancsfájl futtatása varázsló szkript kiválasztása a listából.On the Script page of the Run Script wizard, choose a script from the list. Csak a jóváhagyott szkriptek jelennek meg.Only approved scripts are shown.
  6. Kattintson a tovább, majd fejezze be a varázslót.Click Next, and then complete the wizard.

Fontos

Ha a parancsfájl nem fut, például mert a céleszközt ki van kapcsolva, az adott órában egy adott időszakban, újra kell futtatnia.If a script does not run, for example because a target device is turned off during the one hour time period, you must run it again.

Célként megadott gép végrehajtásaTarget machine execution

A szkript végrehajtása a rendszer vagy számítógép a megcélzott ügyféltől/ügyfelektől érkezők-fiókot.The script is executed as the system or computer account on the targeted client(s). Ez a fiók korlátozott hálózati hozzáféréssel rendelkezik.This account has limited network access. Férjen hozzá a távoli rendszerek és a parancsfájl által helyek ennek megfelelően kell létrehozni.Any access to remote systems and locations by the script must be provisioned accordingly.

Figyelési parancsprogramScript monitoring

Egy szkript futtatásakor eszközöket tartalmazó gyűjtemény kezdeményezése után az alábbi eljárás használatával figyelheti meg a műveletet.After you have initiated running a script on a collection of devices, use the following procedure to monitor the operation. 1710-es verziójával kezdve Ön is a parancsfájl valós időben figyelni a végrehajtása, és a egy adott parancsfájl futtatása végrehajtási jelentés is visszatérhet.Beginning with version 1710, you are both able to monitor a script in real time as it executes, and you can also return to a report for a given Run Script execution.

Parancsfájl figyelő - parancsfájl futtatása állapota

  1. A Configuration Manager konzolon kattintson a figyelés.In the Configuration Manager console, click Monitoring.
  2. Az a figyelés munkaterületen kattintson a parancsfájl állapota.In the Monitoring workspace, click Script Status.
  3. Az a parancsfájl állapota listában, akkor tekintse meg az eredményeket minden parancsprogramhoz futtatta az ügyféleszközökön.In the Script Status list, you view the results for each script you ran on client devices. A parancsfájl kilépési kód 0 általában azt jelzi, hogy a parancsprogram sikeresen lefutott-e.A script exit code of 0 generally indicates that the script ran successfully.
    • A Configuration Manager az 1802-es verziótól kezdve parancsprogram kimenete a rendszer csonkolja a 4 KB-os, hogy a képernyő jobb élményt.Beginning in Configuration Manager 1802, script output is truncated to 4 KB to allow for better display experience. Parancsfájl figyelője – csonkolt parancsfájl Script monitor - Truncated Script

Parancsprogram kimeneteScript Output

  • A Configuration Manager verziója az 1802-től kezdődően parancsprogram kimenete adja vissza, használja a JSON formázását.Starting in Configuration Manager version 1802, script output returns using JSON formatting. Ez a formátum következetesen olvasható parancsfájlkimenetből adja vissza.This format consistently returns a readable script output.
  • Parancsfájlok, amely egy ismeretlen eredményének beolvasása, vagy ahol az ügyfél offline állapotban van, nem jelennek meg, vagy az adatkészlet.Scripts that get an unknown result, or where the client was offline, won't show in the charts or data set.
  • Ne használjon nagy parancsprogram kimenete visszaadása, mivel 4 KB-os, a rendszer csonkolja azt.Avoid returning large script output since it is truncated to 4 KB.
  • Bizonyos funkciók, a parancsfájl kimeneti formázás nem érhető el, ha futtatja az 1802-es verziója a Configuration Manager vagy újabb, az ügyfél régebbi verziójú verziójával.Some functionality with script output formatting is not available when running Configuration Manager version 1802 or later with a down-level version of the client.
    • Az 1802-előtti Configuration Manager-ügyfél rendelkezik, kap egy karakterlánc-kimenet.When you have a pre-1802 Configuration Manager client, you get a string output.
    • A Configuration Manager ügyfél 1802-es verzió vagy újabb, akkor kaphat a JSON formázását.For Configuration Manager client version 1802 and above, you get JSON formatting.
      • Például tegyük fel, hogy a szöveg egy ügyfél verziója az eredményeket, és a "TEXT" (a kimenet csúcsos idézőjelek között) előfordulhat, hogy gyorsan a más verziót, amely két különböző kategóriák szerint diagram kerülnek.For example, you might get results that say TEXT on one client version and "TEXT" (the output is surrounded in double quotes) on other version, which will be put in chart as two different categories.
      • Ha megkerülő van szüksége, fontolja meg, két különböző gyűjteményekhez parancsfájlt futtat.If you need to work around this behavior, consider running script against two different collections. Az egyik az 1802-előtti ügyfelek és a egy másik, az 1802-es és újabb ügyfelek.One with pre-1802 clients and another with 1802 and higher clients. Másik lehetőségként átválthat enum objektum egy karakterláncértéket szkriptekkel, azok megfelelően jelennek meg a JSON formázását.Or, you can convert an enum object to a string value in scripts so they are properly displayed in JSON formatting.
  • Enum objektum konvertálása egy karakterláncértéket a parancsfájlok, így azok megfelelően jelennek meg a JSON formázását.Convert an enum object to a string value in scripts so they are properly displayed in JSON formatting. Enum objektum alakítható át egy karakterlánc-érték Convert enum object to a sting value

Lásd még:See Also