Approve-CMScript

  • Referência
Módulo:
ConfigurationManager

Aprove um script do PowerShell em Configuration Manager.

Syntax

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

Description

Use este cmdlet para aprovar um script do Powershell no Configuration Manager. Esses scripts são integrados e gerenciados em Configuration Manager. Você não pode executar um script em dispositivos até que ele seja aprovado. Depois de aprovar um script, para executá-lo, use o cmdlet Invoke-CMScript .

Por padrão, você não pode aprovar scripts que você criar.

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: aprovar um script usando a ID do script

Esse comando aprova um script que tem a ID DF8E7546-FD66-4A3D-A129-53AF5AA54F80.

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

Exemplo 2: aprovar um script usando a variável de objeto script

O primeiro comando obtém um objeto script com 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 em massa todos os scripts não aprovados

Esse comando obtém todos os scripts em Configuration Manager que não foram aprovados. Em seguida, ele passa por cada script na matriz de scripts . Se o usuário atual não for o autor do script, ele o aprovará.

$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.

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

-Confirm

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

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

-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

-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

-InputObject

Especifique um objeto script a ser aprovado. Para obter esse objeto, use o cmdlet Get-CMScript .

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

-ScriptGuid

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

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

-WhatIf

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

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object