Invoke-CMScript
SINOPSE
Invoque um script no Gestor de Configuração.
SINTAXE
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>]
DESCRIÇÃO
O cmdlet Invoke-CMScript invoca um script PowerShell no Gestor de Configuração. O Gestor de Configuração tem uma capacidade integrada de executar scripts PowerShell. Os scripts simplificam a construção de ferramentas personalizadas para administrar software e permitem realizar tarefas mundanas rapidamente, permitindo-lhe obter grandes trabalhos feitos de forma mais fácil e consistente. Para obter mais informações, consulte Criar e executar scripts PowerShell a partir da consola 'Gestor de Configuração'.
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.
EXEMPLOS
Exemplo 1: Invocar um script utilizando o id script
Este comando invoca um script que tem o ID DF8E7546-FD66-4A3D-A129-53AF5AA54F80 .
Invoke-CMScript -ScriptGuid "DF8E7546-FD66-4A3D-A129-53AF5AA54F80"
Exemplo 2: Invocar um script utilizando a variável do objeto do script
O primeiro comando obtém um objeto CMScript pelo seu ID e, em seguida, armazena-o na variável $ScriptObj. O segundo comando invoca o guião armazenado nessa variável.
$ScriptObj = Get-CMScript -Id "DF8E7546-FD66-4A3D-A129-53AF5AA54F80"
Invoke-CMScript -InputObject $ScriptObj
Exemplo 3: Passar parâmetros para o script-alvo
A primeira linha armazena parâmetros numa tabela hash. A segunda linha invoca o script no dispositivo de destino, ao transmitir os parâmetros na tabela hash.
$Hash = @{"FolderName"="c:\test\test1"; "FileName"="test2"}
Invoke-CMScript -ScriptGuid $scriptGuid -Device (Get-CMDevice -Name $targetPCName) -ScriptParameter $Hash
PARÂMETROS
-Coleção
Especifique um objeto de coleção. Para obter este objeto, utilize o 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
Especifique o ID de uma coleção.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome de coleção
Especifique o nome de uma coleção.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Dispositivo
Especifique um objeto do dispositivo no Gestor de Configuração. Para obter este objeto, utilize o 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
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Especifique um objeto de script do Gestor de Configuração. Para obter este objeto, utilize o 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
Devolve um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ScriptGuid
Especifique o ID do guião. O formato THe é um GUID padrão.
Type: String
Parameter Sets: ByGuid
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ScriptParameter
Aplica-se à versão 2010 e mais tarde. Utilize este parâmetro para passar parâmetros para o script alvo. Especifique uma tabela hash com os parâmetros necessários. Para um exemplo de utilização, consulte Exemplos.
Type: Hashtable
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- O QueIf
Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não é executado.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.