Compartilhar via


Approve-CMScript

Aprovar um script do PowerShell no Configuration Manager.

Sintaxe

Approve-CMScript
       [-Comment <String>]
       -InputObject <IResultObject>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Approve-CMScript
       [-Comment <String>]
       -ScriptGuid <String>
       [-DisableWildcardHandling]
       [-ForceWildcardHandling]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Utilize este cmdlet para aprovar um script do Powershell no Configuration Manager. Estes scripts são integrados e geridos no Configuration Manager. Não pode executar um script em dispositivos até que seja aprovado. Depois de aprovar um script, para executá-lo, utilize o cmdlet Invoke-CMScript .

Por predefinição, não pode aprovar scripts que cria.

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: Aprovar um script com o ID do script

Este comando aprova um script com o ID DF8E7546-FD66-4A3D-A129-53AF5AA54F80.

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

Exemplo 2: Aprovar um script com a variável de objeto de script

O primeiro comando obtém um objeto de script com o ID DF8E7546-FD66-4A3D-A129-53AF5AA54F80. Em seguida, armazena o objeto na variável $ScriptObj .

O segundo comando aprova o script armazenado na variável .

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

Exemplo 3: aprovar todos os scripts não aprovados em massa

Este comando obtém todos os scripts no Configuration Manager que não são aprovados. Em seguida, percorre cada script na matriz de scripts . Se o utilizador atual não for o autor do script, aprova-o.

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

$me = $env:userdomain + "\" + $env:username
foreach ( $script in $scripts ) {
  if ( $script.Author -ne $me ) {
    Approve-CMScript -InputObject $script
  }
}

Parâmetros

-Comment

Especifica um comentário sobre a aprovação do script.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-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

-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

-InputObject

Especifique um objeto de script a aprovar. Para obter este objeto, utilize o cmdlet Get-CMScript .

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

-ScriptGuid

Especifique o ID do script a aprovar. O formato é um GUID padrão.

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object