Compartilhar via


Get-CMScript

Obtenha um script do PowerShell no Configuration Manager.

Sintaxe

Get-CMScript
   [-Author <String>]
   [-Fast]
   [-ScriptName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMScript
   [-Author <String>]
   [-Fast]
   -ScriptGuid <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilize este cmdlet para obter um script do PowerShell do Configuration Manager. Estes scripts são integrados e geridos no Configuration Manager. Para obter mais informações, veja Criar e executar scripts do PowerShell a partir da consola do Configuration Manager.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Obter todos os scripts não aprovados

Este comando obtém todos os scripts no Configuration Manager que não são aprovados.

Get-CMScript -Fast | Where-Object { -not $_.ApprovalState }

Exemplo 2: Obter scripts com o nome

Este comando obtém todos os scripts que têm um nome que começa com a letra D.

Get-CMScript -ScriptName "D*"

Exemplo 3: Obter scripts de um autor específico

Este comando obtém todos os scripts do autor com o nome de utilizador jqpublic. Uma vez que utiliza o caráter universal asterisco (*), o domínio específico não importa. Em seguida, devolve uma tabela que lista o nome do script, o estado de aprovação e a hora da última atualização.

Get-CMScript -Fast -Author "*jqpublic" | Select-Object ScriptName, ApprovalState, LastUpdateTime

Parâmetros

-Author

Especifique o autor do script a obter. Por exemplo, contoso\jqpublic.

Pode utilizar carateres universais:

  • *: Múltiplos carateres
  • ?: caráter único
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Fast

Adicione este parâmetro para não atualizar automaticamente as propriedades em diferido. As propriedades em diferido contêm valores relativamente ineficientes a obter. Obter estas propriedades pode causar tráfego de rede adicional e diminuir o desempenho do cmdlet.

Se não utilizar este parâmetro, o cmdlet apresenta um aviso. Para desativar este aviso, defina $CMPSSuppressFastNotUsedCheck = $true.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ScriptGuid

Aplica-se à versão 2010 e posterior. Especifique o GUID de um script a obter.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ScriptName

Especifique um nome de script para obter.

Pode utilizar carateres universais:

  • *: Múltiplos carateres
  • ?: caráter único
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

Entradas

None

Saídas

IResultObject[]

IResultObject

Observações

Este cmdlet devolve um objeto para a classe WMI SMS_Scripts .