Hozzon létre, és a PowerShell-parancsfájlok 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)

A System Center Configuration Manager telepítőprogramra egy integrált Powershell-parancsfájlok futtatása.System Center Configuration Manager has an integrated ability to run Powershell scripts. PowerShell van a előnye, hogy létrehozása kifinomult, megértettem és egy nagyobb közösségi megosztott automatizált parancsfájlokat.Powershell has the benefit of creating sophisticated, automated scripts that are understood and shared with a larger community. A parancsfájlok hozható létre egyéni eszközök felügyeletéhez a szoftver- és lehetővé teszik, hogy gyakorlati feladatok elvégzését gyorsan, lehetővé teszik a nagyméretű feladatok könnyebb és következetesen több egyszerűen.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 szolgáltatás adatbázisának 1706 verzióra egy kiadás előtti funkció.This feature was first introduced in version 1706 as a pre-release feature. 1802 verziójával kezdve ez a funkció most már egy előzetes verziójú funkció.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ót a 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:

  • Létrehozása és szerkesztése a System Center Configuration Managerrel használható parancsfájlok.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 a gyűjteményeket, vagy egyéni 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 parancsfájl eredményt az ügyféleszközökön marad.Get rapid aggregated script results from client devices.
  • A parancsfájl végrehajtása figyelése, és a parancsfájl kimenetében jelentés eredményeinek megtekintése.Monitor script execution and view reporting results from script output.

Figyelmeztetés

A megadott hatványra emelésének parancsfájlok, azt jelezve, szándékos és óvatosan a használatát.Given the power of scripts, we remind you to be intentional and careful with their usage. Mi építettünk a további funkciók segít; elkülönített szerepköreivel és hatóköreivel.We have built in additional safeguards to assist you; segregated roles and scopes. Győződjön meg arról, parancsfájlok pontosságának ellenőrzéséhez őket futtatása előtt, és erősítse meg a nem kívánt parancsfájl végrehajtása érdekében 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. Vegye figyelembe a kiterjesztett karaktereket vagy más címmódosítás, és tájékoztassa saját kezűleg parancsfájlok védelme.Be mindful of extended characters or other obfuscation and educate yourself about securing scripts. További tudnivalók a PowerShell parancsfájl-biztonságLearn more about PowerShell script security

ElőfeltételekPrerequisites

  • PowerShell-parancsfájlok futtathatók, az ügyfél futnia kell verzió PowerShell 3.0-s vagy újabb.To run PowerShell scripts, the client must be running PowerShell version 3.0 or later. Azonban ha egy parancsfájl futtatása PowerShell újabb verziójából származó funkciót tartalmaz, az ügyfél, amelyiken futtatja a parancsfájlt kell futnia 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 a 1706 kiadásban, 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álja, és - parancsfájlok létrehozásához a fióknak rendelkeznie kell létrehozása engedélyeinek SMS parancsfájlok.To import and author scripts - Your account must have Create permissions for SMS Scripts.
  • A fiókjának rendelkeznie jóváhagyásához vagy elutasításához parancsfájlok - jóváhagyás engedélyeinek SMS parancsfájlok.To approve or deny scripts - Your account must have Approve permissions for SMS Scripts.
  • -Parancsfájlok 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.

A Configuration Manager biztonsági szerepköreivel kapcsolatos további információk:For more information about Configuration Manager security roles:
Biztonsági hatókörök futtatási parancsfájlokSecurity scopes for run scripts
Biztonsági szerepkörök futtatási parancsfájlokSecurity 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
  • A paramétertípusok: egész szám, karakterlánc és listáját.Parameter types: integer, string, and list.

Figyelmeztetés

Vegye figyelembe, hogy paraméterek használata esetén nyílik meg egy PowerShell injektálási támadás kockázatot területet.Be aware that when using parameters, it opens a surface area for potential PowerShell injection attack risk. Mérséklése és megoldása, például reguláris kifejezésekkel paraméter ellenőrzése különböző módja van, vagy használja az előre megadott paraméterek.There are various ways to mitigate and work around, such as using regular expressions to validate parameter input or using predefined parameters. Közös ajánlott eljárás a beállítás visszaállíthatók, a PowerShell-parancsfájlok (nincs jelszavak visszaállítása stb.) a titkos kulcsok.Common best practice is not to include to secrets in your PowerShell scripts (no passwords, etc.). További tudnivalók a PowerShell parancsfájl-biztonság Learn more about PowerShell script security

Parancsfájl futtatása szerzők és a jóváhagyóknakRun Script authors and approvers

Futtassa a parancsfájlokat használ fogalma szerzők parancsfájl és jóváhagyóknak parancsfájl , külön szerepkörök végrehajtása és a parancsfájl végrehajtása.Run Scripts uses the concept of script authors and script approvers as separate roles for implementation and execution of a script. A tagolt Szerző és a jóváhagyó szerepkör segítségével egy fontos folyamat, ellenőrizze az erőteljes 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. 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: parancsfájlok 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ók nem hagyhat jóvá azok hozták létre parancsfájlt.By default, users cannot approve a script they have authored. Mivel a parancsfájlok teljesítményű, sokoldalú és potenciálisan sok eszközökre telepített, elkülönítheti a szerepkörök között hoznak létre a parancsfájl személlyel, és a személy, amely elfogadja a parancsfájl.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 további szintű biztonságot, a felügyelet nélküli parancsfájl futtatása ellen.These roles give an additional level of security against running a script without oversight. Tudunk kapcsolja ki a másodlagos jóváhagyást, egyszerű tesztelése.You are able to turn off secondary approval, for ease of testing.

Jóváhagyásához vagy elutasításához parancsfájlApprove or Deny a script

Parancsfájlok kell jóváhagyni, ha a jóváhagyó parancsfájl szerepkör, mielőtt azok lefutnának.Scripts must be approved, by the script approver role, before they can be run. Jóváhagyásra váró parancsfájlt: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ületet, kattintson a parancsfájlok.In the Software Library workspace, click Scripts.
  3. Az a parancsfájl menüben válassza ki a parancsfájl jóváhagyásához vagy elutasításához szeretne, majd a a Home lap a parancsfájl csoportjában kattintson 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 vagy parancsfájl megtagadása párbeszédpanelen jelölje ki jóváhagyás, vagy Megtagadás a parancsfájl.In the Approve or deny script dialog box, select Approve, or Deny for the script. Megadhatja a döntési kapcsolatos megjegyzéseit.Optionally, enter a comment about your decision. Ha megtagadja a parancsfájl nem futtatható 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ájában, megjelenik a jóváhagyási állapotot oszlop módosítása attól függően, hogy a művelet.In the Script list, you see the Approval State column change depending on the action you took.

Engedélyezése a felhasználók számára a saját parancsfájlok jóváhagyásaAllow users to approve their own scripts

Ez a jóváhagyás elsősorban a parancsfájl fejlesztési tesztelési fázisában.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. Helyek listáját, válassza ki a helyet, majd a a Home 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őbe a négyzet jelölésének törlésével szüntetheti ne engedélyezze a parancsfájl szerzők saját parancsfájlok jóváhagyása.On the General tab of the Hierarchy Settings Properties dialog box, clear the checkbox Do not allow script authors to approve their own scripts.

Fontos

Ajánlott eljárásként nem engedélyezi egy parancsfájl szerzőjéhez, és hagyja jóvá a saját parancsfájlok.As a best practice, you shouldn't allow a script author to approve their own scripts. Ez csak engedélyezni kell a labor beállításban.It should only be allowed in a lab setting. Alaposan gondolja át, hogy a célgyűjtemény éles környezetben a beállítás módosítása.Carefully consider the potential impact of changing this setting in a production environment.

Biztonsági hatókörökSecurity scopes

(Bevezetett 1710-es verzió)(Introduced with version 1710)
Futtassa a parancsfájlok által használt biztonsági hatókörök, egy meglévő Configuration Manager szolgáltatás szerzői ellenőrzési parancsfájlok és végrehajtás keresztül, amelyek megfelelnek a felhasználói csoportok címkék hozzárendelése.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.

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

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

  1. Nyissa meg a Configuration Manager konzol felügyeleti >biztonsági >biztonsági szerepkörökIn the Configuration Manager console, go to Administration >Security >Security Roles
  2. Kattintson a jobb gombbal a szerepkört, majd másolási.Right-click on a role and click Copy. A szerepkör másolása jogosult már hozzá van rendelve.The role you copy has permissions already assigned. Ellenőrizze, hogy csak a kívánt engedélyek választja.Make sure you take only the permissions that you want.
  3. Az egyéni szerepkör adjon egy neve és egy leírás.Give the custom role a Name and a Description.
  4. A biztonsági szerepkör az alábbiakban leírt engedélyek hozzárendelése.Assign the security role the permissions outlined below.

Biztonsági szerepkör engedélyeitSecurity Role Permissions

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

  • Leírás: Ezek az engedélyek engedélyezi ezt a szerepkört csak a korábban létrehozott és más szerepkörök jóvá parancsfájlok futtatását.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ő értékre van beállítva Igen.Permissions: Ensure the following are set to Yes.
KategóriaCategory EngedélyPermission ÁllapotState
GyűjteményCollection Parancsfájl futtatásaRun Script IgenYes
HelySite OlvasásRead IgenYes
SMS parancsfájlokSMS Scripts Hozzon létreCreate IgenYes
SMS parancsfájlokSMS Scripts OlvasásRead IgenYes

Szerepkör neve: Parancsfájl szerzőkRole Name: Script Authors

  • Leírás: Ezek az engedélyek engedélyezése ennek a szerepkörnek Szerző parancsfájlok, de nem hagyja jóvá vagy futtatni azokat.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, az alábbi engedélyek beállítása.Permissions: Ensure the following permissions are set.
KategóriaCategory EngedélyPermission ÁllapotState
GyűjteményCollection Parancsfájl futtatásaRun Script NemNo
HelySite OlvasásRead IgenYes
SMS parancsfájlokSMS Scripts Hozzon létreCreate IgenYes
SMS parancsfájlokSMS Scripts OlvasásRead IgenYes
SMS parancsfájlokSMS Scripts TörlésDelete IgenYes
SMS parancsfájlokSMS Scripts MódosításModify IgenYes

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

  • Leírás: Ezek az engedélyek engedélyezi ezt a szerepkört parancsfájlok jóváhagyása, de nem hozhatók létre és futtathatók.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, az alábbi engedélyek beállítása.Permissions: Ensure the following permissions are set.
KategóriaCategory EngedélyPermission ÁllapotState
GyűjteményCollection Parancsfájl futtatásaRun Script NemNo
HelySite OlvasásRead IgenYes
SMS parancsfájlokSMS Scripts OlvasásRead IgenYes
SMS parancsfájlokSMS Scripts JóváhagyásaApprove IgenYes
SMS parancsfájlokSMS Scripts MódosításModify IgenYes

SMS parancsfájlok engedélyekkel a parancsfájl szerzők szerepkör – példaExample of SMS Scripts permissions for the script authors role

SMS parancsfájlok engedélyekkel a parancsfájl szerzők szerepkör – 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ületet, kattintson a parancsfájlok.In the Software Library workspace, click Scripts.
  3. Az a Home lap a létrehozása 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 oldalán parancsfájl varázsló, a következő beállításokat:On the Script page of the Create Script wizard, configure the following settings:
    • Parancsfájl neve -adja meg a parancsfájl nevét.Script Name - Enter a name for the script. Bár létrehozhat több parancsfájl ugyanazzal a névvel, duplikált nevek használata megnehezíti a parancsfájl kell megtalálhatja a Configuration Manager konzolon.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.
    • Nyelvi parancsfájl -jelenleg csak a PowerShell-parancsfájlok használata támogatott.Script language - Currently, only PowerShell scripts are supported.
    • Importálás – egy PowerShell-parancsfájlt importálnia kell a konzolt.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.
    • Törölje a jelet -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 esetén 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 állapotú lista jóváhagyásra vár.The new script is displayed in the Script list with a status of Waiting for approval. Ez a parancsfájl 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álata esetén.Avoid scripting a device reboot or a restart of the Configuration Manager agent when using the Run Scripts feature. Így előfordulhat, hogy egy folyamatos újraindítás állapotát.Doing so could lead to a continuous rebooting state. Szükség esetén vannak, amelyek lehetővé teszik az újraindítás eszközök, a Configuration Manager verziója 1710 kezdve az ügyfél-értesítési szolgáltatás fejlesztései.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ók a számítógép újraindítását igénylő eszközök.The pending restart column can help identify devices that need a restart.

Parancsfájl-paraméterekScript parameters

(Bevezetett 1710-es verzió)(Introduced with version 1710)
Paraméterek hozzáadása egy parancsfájl a munka nagyobb rugalmasságot biztosít.Adding parameters to a script provides increased flexibility for your work. A következő ismerteti a parancsfájlok futtatása szolgáltatás aktuális képesség a parancsprogram paramétereinek; 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ípusú, megjelenik egy figyelmeztetés.If your script has unsupported data types, you get a warning.

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

A parancsprogram paramétereinek mindegyiknek saját részleteit és az érvényesítés hozzáadása párbeszédpanelen.Each of your script's parameters has its own dialog for adding further details and validation.

Fontos

A paraméterértékek aposztróf nem tartalmazhat.Parameter values can't contain an apostrophe.
Egy ismert probléma van a Configuration Manager verziója 1802 ahol paramétereket szóközökkel nem lett továbbítva 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. Egy helyet a paraméter használata esetén a paraméter csak az első elem kerülnek a parancsfájlt, és minden követően a terület nem kerül át.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 lehet parancsprogramot futtatni a Ez elkerülhető, és alternatív karakter a szóközt, és azokat, vagy más módszerrel.Admins can script around this by substituting alternate characters for spaces and converting them, or with other methods.

A paraméter érvényesítéseParameter validation

Minden paraméternek a parancsfájl egy parancsfájl jelentésparaméter tulajdonságai ahhoz, hogy az adott paraméter érvényesítése hozzáadása párbeszédpanelen.Each parameter in your script has a Script Parameter Properties dialog for you to add validation for that parameter. A felvett érvényesítési, hibák felvételekor értéket a paraméter, amely nem felel meg az é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: UtónévExample: FirstName

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

Parancsfájl-paraméterek - karakterlánc

Az érvényesítési részében a parancsfájl jelentésparaméter tulajdonságai párbeszédpanelen a következő mezőket a használatra tartalmazza:The validation section of the Script Parameter Properties dialog contains the following fields for your use:

  • Minimális hossz – minimális karaktert száma a Keresztnév mező.Minimum Length - minimum number of characters of the FirstName field.
  • Maximális hossz- legnagyobb karaktert száma a Keresztnév 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 a további információkért lásd: a következő szakaszban reguláris kifejezés használata érvényesítési.For more information on using the Regular Expression, see the next section, Using Regular Expression validation.
  • Az egyéni hibaüzenetek - hasznos, ha a saját egyéni hibaüzenet, amely felülírja a rendszer érvényesítési hibaüzenet.Custom Error - useful for adding your own custom error message that supersedes any system validation error messages.

Érvényesítés reguláris kifejezés használataUsing Regular Expression validation

Reguláris kifejezés olyan programozási elleni egy kódolt érvényesítési karakterlánc ellenőrzése a következő kompakt 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 keressen a beruházási ­ betűvel hiányában a Keresztnév mezőjében úgy, hogy [^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, ez a párbeszédpanel számára történő feldolgozásakor. a .NET-keretrendszer támogatja.The regular expression processing for this dialog is supported by the .NET Framework. A reguláris kifejezésekkel útmutatóért lásd: .NET reguláris kifejezés.For guidance on using regular expressions, see .NET Regular Expression.

Parancsfájl-példákScript examples

Íme néhány példa erre, amelyek a parancsfájlok-érdemes használni ezt a képességet szemléltetik.Here are a couple examples that illustrate scripts you might want to use with this capability.

Hozzon létre egy új mappához és fájlhoz:Create a new folder and file

Ezt a parancsfájlt hoz létre egy új mappát és a fájl a mappában, a elnevezési bemeneti megadott.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ós rendszer verziójának beolvasásaGet OS Version

A parancsfájl WMI lekérdezni az operációs rendszer verziója a gépen.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, egyetlen eszközt vagy egy gyűjtemény futtatható.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 az eszköztárat gyorsan keresztül egy magas prioritású rendszer, amely időtúllépés következik be egy óra.Once execution of your script begins, it is launched quickly through a high priority system that times-out in one hour. A parancsfájl majd eredményeinek állapot üzenet rendszert használ.The results of the script are then returned using a state message system.

A parancsfájl célok 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 az eszközök, amelyeken a parancsfájl futtatásához kívánja a gyűjteményben.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 az Ön által választott, kattintson a -parancsfájl futtatása.Select a collection of your choice, click Run Script.
  5. Az a parancsfájl oldalán a -parancsfájl futtatása varázsló listájából válasszon ki egy parancsfájlt.On the Script page of the Run Script wizard, choose a script from the list. Csak a jóváhagyott parancsfájlok jelennek meg.Only approved scripts are shown.
  6. Kattintson a következő, majd fejezze be a varázslót.Click Next, and then complete the wizard.

Fontos

Ha a parancsfájl nem működik, például mert a céleszközön az időszak egy óra alatt ki van kapcsolva, akkor ú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 parancsfájl végrehajtása a rendszer vagy számítógép a célzott fogadják a fiókot.The script is executed as the system or computer account on the targeted client(s). Ez a fiók csak korlátozott hálózati hozzáférést.This account has limited network access. Ennek megfelelően ki kell építenie távoli rendszerek és a parancsfájl által helyek elérését.Any access to remote systems and locations by the script must be provisioned accordingly.

Figyelési parancsprogramScript monitoring

A parancsfájl futó eszközök kezdeményezése után a következő eljárással figyelése a műveletet.After you have initiated running a script on a collection of devices, use the following procedure to monitor the operation. 1710 verziójával kezdve áll is figyelemmel kísérheti a valós idejű parancsfájl végrehajtása, és a jelentés egy adott parancsfájl futtatása végrehajtásra 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. Kattintson a Configuration Manager konzolon figyelés.In the Configuration Manager console, click Monitoring.
  2. Az a figyelés munkaterületet, kattintson a parancsfájl állapot.In the Monitoring workspace, click Script Status.
  3. Az a parancsfájl állapot lista, akkor tekintse meg az eredményeket minden parancsprogram futtatása 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 hibakód 0 általában azt jelzi, hogy a parancsfájl sikeresen lefutott-e.A script exit code of 0 generally indicates that the script ran successfully.
    • A Configuration Manager 1802 kezdve parancsfájl kimenetében méretűre csonkolja jobb megjelenítési élmény lehetővé a 4 KB-os.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

Parancsfájl kimenetiScript Output

  • A Configuration Manager verziója 1802 kezdődően parancsfájl kimenetében adja vissza, JSON formázással.Starting in Configuration Manager version 1802, script output returns using JSON formatting. Ezt a formátumot következetesen egy olvasható parancsfájl-kimenet visszaadása.This format consistently returns a readable script output.
  • Parancsfájlok, amely egy ismeretlen eredményt kapja, vagy ha az ügyfél volt érhető el, a diagramok vagy az adatkészlet nem jelenik.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 parancsfájl kimenetében ad vissza, mivel a 4 KB-os csonkolva.Avoid returning large script output since it is truncated to 4 KB.
  • Bizonyos funkciók parancsfájl kimeneti formázás nem érhető el, ha futtatja a Configuration Manager verziója 1802 vagy újabb, az ügyfél régebbi verziója.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.
    • Ha egy előre-1802 Configuration Manager-ügyfél, kap egy karakterlánc-kimenet.When you have a pre-1802 Configuration Manager client, you get a string output.
    • A Configuration Manager ügyfélverzió 1802 és újabb, akkor a JSON formázást kap.For Configuration Manager client version 1802 and above, you get JSON formatting.
      • Például előfordulhat, hogy elérhetővé eredmények, amelyek mondja ki a szöveget egy ügyfél verziója és a "TEXT" (a kimeneti csúcsos idézőjelek között) más verzión, amelyek két különböző kategóriákként diagram kerüljenek.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 a parancsprogram futtatása ellen két különböző gyűjteményeket.If you need to work around this behavior, consider running script against two different collections. Egy előre-1802 ügyfelek és egy másik 1802, és magasabb szintű ügyfelek.One with pre-1802 clients and another with 1802 and higher clients. Vagy átválthat enum objektum parancsfájlokban karakterlánc-értékkel, megfelelően jelennek meg a formázás JSON-ban.Or, you can convert an enum object to a string value in scripts so they are properly displayed in JSON formatting.
  • Így megfelelően jelennek meg a JSON-ban formázás enum objektum konvertálása parancsfájlokban karakterlánc-érték.Convert an enum object to a string value in scripts so they are properly displayed in JSON formatting. Egy karakterlánc-érték felsorolási objektum konvertálása Convert enum object to a sting value

Lásd még:See Also