Get-CMScript

Obtenha um script do PowerShell em Configuration Manager.

Syntax

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

Description

Use este cmdlet para obter um script Configuration Manager PowerShell. Esses scripts são integrados e gerenciados em Configuration Manager. Para obter mais informações, consulte Criar e executar scripts do PowerShell no console Configuration Manager.

Observação

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

Exemplos

Exemplo 1: Obter todos os scripts não aprovados

Esse comando obtém todos os scripts em Configuration Manager que não foram aprovados.

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

Exemplo 2: obter scripts usando o nome

Esse 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

Esse comando obtém todos os scripts do autor com o nome de usuário jqpublic. Como ele usa o curinga asterisco (*), o domínio específico não importa. Em seguida, ele retorna uma tabela que lista o nome do script, o estado de aprovação e a última atualização.

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

Parâmetros

-Author

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

Você pode usar caracteres curinga:

  • *: vários caracteres
  • ?: caractere único
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-Fast

Adicione esse parâmetro para não atualizar automaticamente propriedades preguiçosas. Propriedades preguiçosas contêm valores relativamente ineficientes para recuperar. Obter essas propriedades pode causar tráfego de rede adicional e diminuir o desempenho do cmdlet.

Se você não usar esse parâmetro, o cmdlet exibirá um aviso. Para desabilitar esse aviso, defina $CMPSSuppressFastNotUsedCheck = $true.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-ScriptGuid

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

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

-ScriptName

Especifique um nome de script a ser obtido.

Você pode usar caracteres curinga:

  • *: vários caracteres
  • ?: caractere único
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

Entradas

None

Saídas

IResultObject[]

IResultObject

Observações

Este cmdlet retorna um objeto para a classe WMI SMS_Scripts .