Invoke-CMScript
SYNOPSIS
Szkript meghívása a Konfigurációkezelő.
SYNTAX
ByInputObject
Invoke-CMScript [-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>]
[-Device <IResultObject[]>] -InputObject <IResultObject> [-PassThru] [-ScriptParameter <Hashtable>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
ByGuid (Nyelvazonosító)
Invoke-CMScript [-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>]
[-Device <IResultObject[]>] [-PassThru] -ScriptGuid <String> [-ScriptParameter <Hashtable>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Az Invoke-CMScript parancsmag meghív egy PowerShell-szkriptet a Konfigurációkezelő. Konfigurációkezelő rendelkezik PowerShell-szkriptek futtatásának integrált képességével. A szkriptek leegyszerűsítik a szoftverek felügyeletére használt egyéni eszközök építését, és lehetővé teszik a hétköznapi feladatok gyors elvégzését, így könnyebben és egységesebb módon végezhetők el a nagy feladatok. További információ: PowerShell-parancsfájlok létrehozása és futtatása a Konfigurációkezelő konzolról.
Megjegyzés
Futtassa Konfigurációkezelő parancsmagokat a Konfigurációkezelő hely meghajtóról, például: PS XYZ:\> . További információ: Első lépések.
EXAMPLES
1. példa: Szkript meghívása a szkript azonosítójával
Ez a parancs egy DF8E7546-FD66-4A3D-A129-53AF5AA54F80 azonosítójú szkriptet hív meg.
Invoke-CMScript -ScriptGuid "DF8E7546-FD66-4A3D-A129-53AF5AA54F80"
2. példa: Szkript meghívása szkriptobjektum-változó használatával
Az első parancs lekért egy CMScript-objektumot az azonosítója alapján, majd tárolja azt a $ScriptObj változóban. A második parancs meghívja az ebben a változóban tárolt szkriptet.
$ScriptObj = Get-CMScript -Id "DF8E7546-FD66-4A3D-A129-53AF5AA54F80"
Invoke-CMScript -InputObject $ScriptObj
3. példa: Paraméterek bérlete a célszk szkriptnek
Az első sor kivonattáblában tárolja a paramétereket. A második sor meghívja a szkriptet a céleszközön, és a kivonattáblában átadja a paramétereket.
$Hash = @{"FolderName"="c:\test\test1"; "FileName"="test2"}
Invoke-CMScript -ScriptGuid $scriptGuid -Device (Get-CMDevice -Name $targetPCName) -ScriptParameter $Hash
PARAMETERS
-Collection (Gyűjtemény)
Adjon meg egy gyűjteményobjektumot. Az objektum lekért használhatja a Get-CMCollection parancsmagot.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId (Gyűjteményazonosító)
Adja meg egy gyűjtemény azonosítóját.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName (Gyűjtemény neve)
Adja meg egy gyűjtemény nevét.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Device (Eszköz)
Adjon meg egy eszközobjektumot a Konfigurációkezelő. Az objektum leolvasásához használja a Get-CMDevice parancsmagot.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: Devices
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Ez a paraméter literál karakterértékekként kezeli a helyettesítő karaktereket. Nem kombinálhatja a ForceWildcardHandling használatával.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Ez a paraméter feldolgozza a helyettesítő karaktereket, és váratlan viselkedéshez vezethet (nem ajánlott). Nem kombinálhatja a DisableWildcardHandling használatával.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Adjon meg egy Konfigurációkezelő szkriptobjektumot. Az objektum lekért használhatja a Get-CMScript parancsmagot.
Type: IResultObject
Parameter Sets: ByInputObject
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-PassThru
Egy objektumot ad vissza, amely azt az elemet képviseli, amellyel dolgozik. Alapértelmezés szerint ez a parancsmag nem generál kimenetet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ScriptGuid
Adja meg a szkript azonosítóját. A THe formátum egy szabványos GUID.
Type: String
Parameter Sets: ByGuid
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ScriptParameter (Szkriptparaméter)
A 2010-es és újabb verziókra vonatkozik. Ezzel a paraméterrel paramétereket ad át a cél szkriptnek. Adjon meg egy kivonattáblát a szükséges paraméterekkel. Példa a használatra: Példák.
Type: Hashtable
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Ez a parancsmag a következő általános paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction és -WarningVariable. További információ: about_CommonParameters.