Sdílet prostřednictvím


Invoke-CMScript

SYNOPSIS

Vyvolá skript v Configuration Manager.

SYNTAX

ByInputObject

Invoke-CMScript [-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>]
 [-Device <IResultObject[]>] -InputObject <IResultObject> [-PassThru] [-ScriptParameter <Hashtable>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

ByGuid

Invoke-CMScript [-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>]
 [-Device <IResultObject[]>] [-PassThru] -ScriptGuid <String> [-ScriptParameter <Hashtable>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Rutina Invoke-CMScript vyvolá skript prostředí PowerShell v Configuration Manager. Configuration Manager má integrovanou schopnost spouštět skripty prostředí PowerShell. Tyto skripty zjednodušují vytváření vlastních nástrojů pro správu softwaru a umožňují rychle provádět rutinní úkoly, což vám umožní rychleji a častěji pracovat s velkými úlohami. Další informace najdete v tématu Vytvoření a spuštění skriptů PowerShellu z konzoly Configuration Manager.

Poznámka

Použijte například rutiny Configuration Manager z Configuration Manager jednotky webu PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1: vyvolání skriptu pomocí ID skriptu

Tento příkaz vyvolá skript s ID DF8E7546-FD66-4A3D-A129-53AF5AA54F80.

Invoke-CMScript -ScriptGuid "DF8E7546-FD66-4A3D-A129-53AF5AA54F80"

Příklad 2: vyvolání skriptu pomocí proměnné objektu Script

První příkaz načte objekt CMScript podle jeho ID a pak ho uloží do proměnné $ScriptObj . Druhý příkaz vyvolá skript uložený v této proměnné.

$ScriptObj = Get-CMScript -Id "DF8E7546-FD66-4A3D-A129-53AF5AA54F80"

Invoke-CMScript -InputObject $ScriptObj

Příklad 3: předání parametrů cílovému skriptu

První řádek ukládá parametry v zatřiďovací tabulce. Druhý řádek vyvolá skript na cílovém zařízení s předáním parametrů v zatřiďovací tabulce.

$Hash = @{"FolderName"="c:\test\test1"; "FileName"="test2"}

Invoke-CMScript -ScriptGuid $scriptGuid -Device (Get-CMDevice -Name $targetPCName) -ScriptParameter $Hash

PARAMETERS

– Kolekce

Zadejte objekt kolekce. K získání tohoto objektu použijte rutinu Get-CMCollection .

Type: IResultObject
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CollectionId

Zadejte ID kolekce.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CollectionName

Zadejte název kolekce.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

– Zařízení

Zadejte objekt zařízení v Configuration Manager. K získání tohoto objektu použijte rutinu Get-CMDevice .

Type: IResultObject[]
Parameter Sets: (All)
Aliases: Devices

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

Tento parametr považuje zástupné znaky jako literálové hodnoty znaků. Nejde kombinovat s ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučujeme). Nejde kombinovat s DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

– Položky InputObject

Zadejte Configuration Manager objekt skriptu. K získání tohoto objektu použijte rutinu Get-CMScript .

Type: IResultObject
Parameter Sets: ByInputObject
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

– PassThru

Vrátí objekt představující položku, se kterou pracujete. Ve výchozím nastavení tato rutina nemusí generovat žádný výstup.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ScriptGuid

Zadejte ID skriptu. Formát je standardní identifikátor GUID.

Type: String
Parameter Sets: ByGuid
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ScriptParameter

Platí pro verzi 2010 a novější. Tento parametr použijte k předání parametrů cílovému skriptu. Zadejte zatřiďovací tabulku s požadovanými parametry. Příklad použití naleznete v tématu Příklady.

Type: Hashtable
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěná.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement. ManagementProvider. IResultObject

OUTPUTS

System.Object

POZNÁMKY

Schválit – CMScript

Odepřít – CMScript

Get-CMScript

Remove-CMScript

Set-CMScriptDeploymentType

Add-CMScriptDeploymentType