Compartilhar via

Set-CMClientSettingSoftwareUpdate

  • Referência
Módulo:
ConfigurationManager

Configurar definições de cliente para atualizações de software.

Sintaxe

Set-CMClientSettingSoftwareUpdate
   [-BatchingTimeout <Int32>]
   [-DeltaDownloadPort <Int32>]
   [-DeploymentEvaluationSchedule <IResultObject>]
   [-Enable <Boolean>]
   [-EnableDeltaDownload <Boolean>]
   [-EnableDynamicUpdate <Boolean>]
   [-EnableInstallation <Boolean>]
   [-EnableThirdPartyUpdates <Boolean>]
   [-EnableWsusCertPinning <Boolean>]
   [-EnforceMandatory <Boolean>]
   [-Office365ManagementType <Boolean>]
   [-ScanSchedule <IResultObject>]
   [-ThreadPriority <ThreadPriorityType>]
   [-TimeUnit <BatchingTimeoutType>]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMClientSettingSoftwareUpdate
   [-BatchingTimeout <Int32>]
   [-DeltaDownloadPort <Int32>]
   [-DeploymentEvaluationSchedule <IResultObject>]
   [-Enable <Boolean>]
   [-EnableDeltaDownload <Boolean>]
   [-EnableDynamicUpdate <Boolean>]
   [-EnableInstallation <Boolean>]
   [-EnableThirdPartyUpdates <Boolean>]
   [-EnableWsusCertPinning <Boolean>]
   [-EnforceMandatory <Boolean>]
   [-Office365ManagementType <Boolean>]
   [-ScanSchedule <IResultObject>]
   [-ThreadPriority <ThreadPriorityType>]
   [-TimeUnit <BatchingTimeoutType>]
   [-DefaultSetting]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMClientSettingSoftwareUpdate
   [-BatchingTimeout <Int32>]
   [-DeltaDownloadPort <Int32>]
   [-DeploymentEvaluationSchedule <IResultObject>]
   [-Enable <Boolean>]
   [-EnableDeltaDownload <Boolean>]
   [-EnableDynamicUpdate <Boolean>]
   [-EnableInstallation <Boolean>]
   [-EnableThirdPartyUpdates <Boolean>]
   [-EnableWsusCertPinning <Boolean>]
   [-EnforceMandatory <Boolean>]
   [-Office365ManagementType <Boolean>]
   [-ScanSchedule <IResultObject>]
   [-ThreadPriority <ThreadPriorityType>]
   [-TimeUnit <BatchingTimeoutType>]
   -InputObject <IResultObject>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilize este cmdlet para configurar as definições no grupo Atualizações de software das definições de cliente. Para obter mais informações, veja Acerca das definições de cliente: Atualizações de software.

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: Ativar atualizações de terceiros nas predefinições do cliente

Set-CMClientSettingSoftwareUpdate -DefaultSetting -Enable $true -EnableThirdPartyUpdates $true

Exemplo 2: Ativar atualizações de terceiros numa definição de dispositivo personalizada

$clientDeviceSettingName = "Dev device settings"
Set-CMClientSettingSoftwareUpdate -Name $clientDeviceSettingName -Enable $true -EnableThirdPartyUpdates $true

Exemplo 3: Configurar várias definições

Set-CMClientSettingSoftwareUpdate -InputObject $testsetting -Enable $true -ScanSchedule $Sch1 -DeploymentEvaluationSchedule $Sch2 -BatchingTimeout 3 -TimeUnit Days -EnforceMandatory $true -Office365ManagementType $false -EnableThirdPartyUpdates $true -EnableDeltaDownload $true -EnableInstallation $true -ThreadPriority Normal -EnableDynamicUpdate $true

Parâmetros

-BatchingTimeout

Especifique o período de tempo durante o qual todas as implementações pendentes com um prazo neste período também serão instaladas. Utilize este parâmetro com o parâmetro EnforceMandatory . Pode introduzir um valor de 1 a 23 horas e de 1 a 365 dias. Por predefinição, esta definição está configurada para sete dias. Utilize o parâmetro TimeUnit para especificar horas ou dias.

Tipo:Int32
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

-DefaultSetting

Adicione este parâmetro para configurar as definições de atualização de software nas predefinições do cliente.

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

-DeltaDownloadPort

Utilize este parâmetro para configurar a porta de rede que os clientes utilizam para receber pedidos de conteúdo delta. Utilize o parâmetro EnableDeltaDownload para ativar o comportamento. O valor padrão é 8005.

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

-DeploymentEvaluationSchedule

Especifique a frequência com que o agente cliente das atualizações de software reavalia as atualizações de software para o estado de instalação nos computadores cliente do Configuration Manager. Para criar um novo token de agenda, utilize o cmdlet New-CMSchedule .

Tipo:IResultObject
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

-Enable

Defina este parâmetro como para $true ativar as atualizações de software nos clientes.

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

-EnableDeltaDownload

Defina este parâmetro como para $true permitir que os clientes transfiram conteúdos delta quando disponíveis. Para configurar a porta de rede, utilize o parâmetro DeltaDownloadPort .

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

-EnableDynamicUpdate

Aplica-se à versão 2010 e posterior. Defina este parâmetro como para $true ativar a atualização dinâmica para atualizações de funcionalidades do Windows 10. A atualização dinâmica instala pacotes de idiomas, funcionalidades a pedido, controladores e atualizações cumulativas durante a configuração do Windows. Direciona o cliente para transferir estas atualizações a partir da Internet.

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

-EnableInstallation

Aplica-se à versão 2010 e posterior. Defina este parâmetro como para ativar a $true instalação de atualizações de software na janela de manutenção "Todas as implementações" quando a janela de manutenção "Atualização de Software" estiver disponível.

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

-EnableThirdPartyUpdates

Defina este parâmetro como para $true ativar atualizações de software de terceiros.

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

-EnableWsusCertPinning

Aplica-se à versão 2107 e posterior. Defina este parâmetro como para $true impor a afixação de certificado TLS para o cliente do Windows Update para detetar atualizações.

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

-EnforceMandatory

Quando for atingido qualquer prazo de implementação de atualizações de software, instale todas as outras implementações de atualização de software com prazo dentro de um determinado período de tempo. Utilize o parâmetro BatchingTimeout para especificar o período de tempo.

Tipo:Boolean
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

Este cmdlet adiciona as definições de atualização de software ao objeto de definições de cliente que especificar com este parâmetro. Para obter este objeto, utilize o cmdlet Get-CMClientSetting .

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

-Name

Este cmdlet adiciona as definições de atualização de software ao objeto de definições de cliente que este parâmetro atribui aos nomes.

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

-Office365ManagementType

Defina este parâmetro como para $true ativar a gestão do agente de cliente do Microsoft 365 Apps e das definições de instalação.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

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

-ScanSchedule

Especifique a frequência com que o agente cliente de atualizações de software inicia uma análise de avaliação de compatibilidade. Esta análise determina o estado das atualizações de software no cliente. Para criar um novo token de agenda, utilize o cmdlet New-CMSchedule .

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

-ThreadPriority

Aplica-se à versão 2010 e posterior. Especifique uma prioridade de thread para atualizações de funcionalidades do Windows 10.

  • Normal: a Configuração do Windows utiliza mais recursos do sistema e atualizações mais rapidamente. Utiliza mais tempo de processador, pelo que o tempo total de instalação é mais curto, mas a indisponibilidade do utilizador é maior. Este valor é a predefinição.

  • Low: pode continuar a trabalhar no dispositivo enquanto este transfere e atualiza em segundo plano. O tempo total de instalação é mais longo, mas a indisponibilidade do utilizador é mais curta. Poderá ter de aumentar o tempo máximo de execução da atualização para evitar um tempo limite quando utilizar esta opção.

Tipo:ThreadPriorityType
Valores aceitos:Normal, Low
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TimeUnit

Utilize com o parâmetro BatchingTimeout para especificar o período de tempo durante o qual todas as implementações pendentes com um prazo neste período também serão instaladas.

Tipo:BatchingTimeoutType
Valores aceitos:Days, Hours
Cargo:Named
Valor padrão:None
Obrigatório:False
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