{"content":"
","rawMetadata":{"metadata":{"_op_canonicalUrlPrefix":"https://learn.microsoft.com/zh-cn/powershell/","_op_gitContributorInformation":{"author":{"display_name":"Banreet Kaur","id":"92906285","name":"Banreet","profile_url":"https://github.com/Banreet"},"contributors":[{"display_name":"Aaron Czechowski","id":"26784733","name":"aczechowski","profile_url":"https://github.com/aczechowski"},{"display_name":"Sean Wheeler","id":"19415881","name":"sdwheeler","profile_url":"https://github.com/sdwheeler"},{"display_name":"Dan Mabee","id":"40476441","name":"damabe","profile_url":"https://github.com/damabe"},{"display_name":"Jonathan Gao","id":"2213767","name":"mumian","profile_url":"https://github.com/mumian"}],"update_at":"2026/6/25","updated_at_date_time":"2026-06-25T23:16:52.0658733Z"},"_path":"module/configurationmanager/invoke-cmscript.json","_rel":"../../","_tocRel":"../sccm-ps/toc.json","apiPlatform":"powershell","author":"Banreet","breadcrumb_path":"/powershell/sccm/bread/toc.json","canonical_url":"https://learn.microsoft.com/zh-cn/powershell/module/configurationmanager/invoke-cmscript?view=sccm-ps","content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell-ref/blob/main/sccm-ps/ConfigurationManager/Invoke-CMScript.md","default_moniker":"sccm-ps","depot_name":"MSDN.sccm-powershell","document_id":"e0622994-fdbf-0592-03d4-d37db9f958f9","document_version_independent_id":"03a7cffe-6a93-3acd-7ba8-6953e774d54a","external help file":"AdminUI.PS.dll-Help.xml","feedback_product_url":"https://feedbackportal.microsoft.com/feedback/forum/4669adfc-ee1b-ec11-b6e7-0022481f8472","feedback_system":"Standard","git_commit_id":"53f6fcf5eb17543be4f7c14ef4ec77c54716e67a","gitcommit":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/53f6fcf5eb17543be4f7c14ef4ec77c54716e67a/sccm-ps/ConfigurationManager/Invoke-CMScript.md","github_contributors":["Banreet","aczechowski","sdwheeler","damabe","mumian"],"locale":"zh-cn","manager":"laurawi","Module Name":"ConfigurationManager","monikers":["sccm-ps"],"ms.author":"dannygu","ms.date":"09/13/2023","ms.service":"configuration-manager","ms.subservice":"other","ms.topic":"reference","open_to_public_contributors":true,"original_content_git_url":"https://github.com/MicrosoftDocs/sccm-docs-powershell/blob/live/sccm-ps/ConfigurationManager/Invoke-CMScript.md","original_content_git_url_template":"{repo}/blob/{branch}/sccm-ps/ConfigurationManager/Invoke-CMScript.md","PlatyPS schema version":"2.0.0","products":["https://authoring-docs-microsoft.poolparty.biz/devrel/f1499c3b-793f-48c3-a9ce-20285bcc6541"],"site_name":"Docs","title":"Invoke-CMScript","titleSuffix":"Configuration Manager","uhfHeaderId":"MSDocsHeader-Powershell","updated_at":"2026-06-25 11:16 PM","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/invoke-cmscript","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Invoke-CMScript","schemaType":"PowershellCmdlet","summary":"

在 Configuration Manager 中运行 PowerShell 脚本。

\n","uid":"ConfigurationManager.Invoke-CMScript"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.Invoke-CMScript":{"href":"invoke-cmscript","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Invoke-CMScript","schemaType":"PowershellCmdlet","summary":"

在 Configuration Manager 中运行 PowerShell 脚本。

\n","uid":"ConfigurationManager.Invoke-CMScript"}},"description":"

使用此 cmdlet 在 Configuration Manager 中运行 PowerShell 脚本。 这些脚本在 Configuration Manager 中集成和管理。

\n

在脚本获得批准之前，无法运行该脚本。 若要以编程方式批准脚本，请使用 Approve-CMScript cmdlet。

\n

有关详细信息，请参阅 从 Configuration Manager 控制台创建和运行 PowerShell 脚本。

\n
\n

注意

\n

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\\>。 有关详细信息，请参阅 入门。

\n
\n","examples":[{"code":"Invoke-CMScript -ScriptGuid \"DF8E7546-FD66-4A3D-A129-53AF5AA54F80\"","description":"","summary":"

此命令运行 ID DF8E7546-FD66-4A3D-A129-53AF5AA54F80为 的脚本。

\n","title":"示例 1：使用脚本 ID 运行脚本"},{"code":"$ScriptObj = Get-CMScript -Id \"DF8E7546-FD66-4A3D-A129-53AF5AA54F80\"\n\nInvoke-CMScript -InputObject $ScriptObj","description":"","summary":"

第一个命令按其 ID 获取脚本对象，并将其存储在 $ScriptObj 变量中。 第二个命令运行存储在该变量中的脚本。

\n","title":"示例 2：使用对象变量运行脚本"},{"code":"$parameters = @{\n \"FolderName\"=\"c:\\test\\test1\"\n \"FileName\"=\"test2\"\n}\n\nInvoke-CMScript -ScriptGuid $scriptGuid -Device (Get-CMDevice -Name $targetPCName) -ScriptParameter $parameters","description":"","summary":"

第一行将参数存储在哈希表中。 第二行在目标设备上运行脚本，并在哈希表中传递参数。

\n","title":"示例 3：将参数传递给目标脚本"}],"inputs":[{"description":"","name":"Microsoft.ConfigurationManagement.ManagementProvider.IResultObject\n"}],"links":[{"href":"approve-cmscript","text":"Approve-CMScript"},{"href":"deny-cmscript","text":"Deny-CMScript"},{"href":"get-cmscript","text":"Get-CMScript"},{"href":"new-cmscript","text":"New-CMScript"},{"href":"remove-cmscript","text":"Remove-CMScript"},{"href":"set-cmscript","text":"Set-CMScript"},{"href":"/mem/configmgr/apps/deploy-use/create-deploy-scripts","text":"从 Configuration Manager 控制台创建并运行 PowerShell 脚本"}],"module":"ConfigurationManager","name":"Invoke-CMScript","notes":"","outputs":[{"description":"","name":"System.Object\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"

指定要运行此脚本的集合对象。 若要获取此对象，请使用 Get-CMCollection cmdlet。

\n","name":"Collection","parameterValueGroup":"","position":"Named","type":"IResultObject\n"},{"aliases":"","defaultValue":"None","description":"

指定要运行此脚本的集合的 ID。

\n","name":"CollectionId","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

指定要运行此脚本的集合的名称。

\n","name":"CollectionName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"cf","defaultValue":"None","description":"

提示你在运行 cmdlet 之前进行确认。

\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"Devices","defaultValue":"None","description":"

为设备指定对象以运行此脚本。 若要获取此对象，请使用 Get-CMDevice cmdlet。

\n","name":"Device","parameterValueGroup":"","position":"Named","type":"

IResultObject[]

\n"},{"aliases":"","defaultValue":"None","description":"

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"

此参数处理通配符，并可能导致意外行为， (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"

指定要运行的脚本对象。 若要获取此对象，请使用 Get-CMScript cmdlet。

\n","isRequired":true,"name":"InputObject","parameterValueGroup":"","pipelineInput":true,"position":"Named","type":"IResultObject\n"},{"aliases":"","defaultValue":"None","description":"

返回一个 对象，该对象表示正在使用的项。 默认情况下，此 cmdlet 可能不会生成任何输出。

\n","name":"PassThru","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"

指定 UTC DateTime 以计划稍后执行脚本。

\n","name":"ScheduleTime","parameterValueGroup":"","position":"Named","type":"DateTime\n"},{"aliases":"","defaultValue":"None","description":"

指定要运行的脚本的 ID。 格式是标准 GUID。

\n","isRequired":true,"name":"ScriptGuid","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"

适用于版本 2010 及更高版本。 使用此参数可将参数传递给目标脚本。 使用所需参数指定哈希表。 有关用法的示例，请参阅 示例。

\n","name":"ScriptParameter","parameterValueGroup":"","position":"Named","type":"Hashtable\n"},{"aliases":"wi","defaultValue":"None","description":"

显示在 cmdlet 运行时发生的情况。 该 cmdlet 未运行。

\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"

在 Configuration Manager 中运行 PowerShell 脚本。

\n","syntaxes":["Invoke-CMScript [-Collection ] [-CollectionId ] [-CollectionName ]\n [-Device ] -InputObject [-PassThru] [-ScriptParameter ]\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] []","Invoke-CMScript [-Collection ] [-CollectionId ] [-CollectionName ]\n [-Device ] [-PassThru] -ScriptGuid [-ScriptParameter ]\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] []"],"uid":"ConfigurationManager.Invoke-CMScript","hideEdit":true,"ms.translationtype":"MT","ms.contentlocale":"zh-cn","loc_version":"2024-08-21T21:18:36.7205003Z","loc_source_id":"Github-72476255#live","loc_file_id":"Github-72476255.live.MSDN.sccm-powershell.sccm-ps/ConfigurationManager/Invoke-CMScript.md","xrefs":[{"href":"https://learn.microsoft.com/powershell/module/configurationmanager/invoke-cmscript","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Invoke-CMScript","schemaType":"PowershellCmdlet","summary":"

在 Configuration Manager 中运行 PowerShell 脚本。

\n","uid":"ConfigurationManager.Invoke-CMScript"}],"canonical_url":"https://learn.microsoft.com/zh-cn/powershell/module/configurationmanager/invoke-cmscript?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/zh-cn/powershell/module/configurationmanager/invoke-cmscript?view=sccm-ps"},"pageMetadata":"使用此 cmdlet 在 Configuration Manager 中运行 PowerShell 脚本。 这些脚本在 Configuration Manager 中集成和管理。

\n

在脚本获得批准之前，无法运行该脚本。 若要以编程方式批准脚本，请使用 Approve-CMScript cmdlet。

\n

有关详细信息，请参阅 从 Configuration Manager 控制台创建和运行 PowerShell 脚本。

\n
\n

注意

\n

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\\>。 有关详细信息，请参阅 入门。

\n
\n\" />\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n\r\n在 Configuration Manager 中运行 PowerShell 脚本。

\n\" />\r\n] [-CollectionId ] [-CollectionName ]\n [-Device ] -InputObject [-PassThru] [-ScriptParameter ]\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] []\" />\r\n] [-CollectionId ] [-CollectionName ]\n [-Device ] [-PassThru] -ScriptGuid [-ScriptParameter ]\n [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] []\" />\r\n\r\n","themesRelativePathToOutputRoot":"_themes/"}