Invoke-CMScript
SYNOPSIS
Wywołaj skrypt w Menedżer konfiguracji.
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
Polecenie cmdlet Invoke-CMScript wywołuje skrypt programu PowerShell w Menedżer konfiguracji. Menedżer konfiguracji ma zintegrowaną możliwość uruchamiania skryptów programu PowerShell. Skrypty upraszczają tworzenie niestandardowych narzędzi do administrowania oprogramowaniem i umożliwiają szybkie wykonywanie dużych zadań, co pozwala łatwiej i spójniej wykonywać duże zadania. Aby uzyskać więcej informacji, zobacz Tworzenie i uruchamianie skryptów programu PowerShell z Menedżer konfiguracji konsoli programu.
Uwaga
Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.
EXAMPLES
Przykład 1: Wywoływanie skryptu przy użyciu identyfikatora skryptu
To polecenie wywołuje skrypt o identyfikatorze DF8E7546-FD66-4A3D-A129-53AF5AA54F80.
Invoke-CMScript -ScriptGuid "DF8E7546-FD66-4A3D-A129-53AF5AA54F80"
Przykład 2: Wywoływanie skryptu przy użyciu zmiennej obiektu skryptu
Pierwsze polecenie pobiera obiekt CMScript według jego identyfikatora, a następnie zapisuje go w $ScriptObj zmiennej. Drugie polecenie wywołuje skrypt przechowywany w tej zmiennej.
$ScriptObj = Get-CMScript -Id "DF8E7546-FD66-4A3D-A129-53AF5AA54F80"
Invoke-CMScript -InputObject $ScriptObj
Przykład 3: przekaż parametry do skryptu docelowego
Pierwszy wiersz przechowuje parametry w tablicy skrótów. Drugi wiersz wywołuje skrypt na urządzeniu docelowym, przekazując parametry w tablicy skrótów.
$Hash = @{"FolderName"="c:\test\test1"; "FileName"="test2"}
Invoke-CMScript -ScriptGuid $scriptGuid -Device (Get-CMDevice -Name $targetPCName) -ScriptParameter $Hash
PARAMETERS
-Collection (Kolekcja)
Określ obiekt kolekcji. Aby uzyskać ten obiekt, użyj polecenia cmdlet Get-CMCollection.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Określ identyfikator kolekcji.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Określ nazwę kolekcji.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Urządzenia
Określ obiekt urządzenia w Menedżer konfiguracji. Aby uzyskać ten obiekt, użyj polecenia cmdlet 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
Ten parametr traktuje symbole wieloznaczne jako wartości znaków literału. Nie można połączyć go z forceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Określ obiekt Menedżer konfiguracji skryptu. Aby uzyskać ten obiekt, użyj polecenia cmdlet 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
Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet może nie generować żadnych danych wyjściowych.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ScriptGuid
Określ identyfikator skryptu. Format THe jest standardowym identyfikatorem GUID.
Type: String
Parameter Sets: ByGuid
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ScriptParameter
Dotyczy wersji 2010 i nowszych. Użyj tego parametru, aby przekazać parametry do skryptu docelowego. Określ tablicę skrótów z wymaganymi parametrami. Aby uzyskać przykład użycia, zobacz Przykłady.
Type: Hashtable
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Typowe parametry
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.