Share via

Set-CMClientSettingSoftwareUpdate

  • Referência
Módulo:
ConfigurationManager

Configure as configurações do cliente para atualizações de software.

Syntax

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

Use este cmdlet para definir configurações no grupo Atualizações de software das configurações do cliente. Para obter mais informações, consulte Sobre configurações do cliente: Atualizações de software.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Habilitar atualizações de terceiros nas configurações padrão do cliente

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

Exemplo 2: Habilitar atualizações de terceiros em uma configuração de dispositivo personalizada

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

Exemplo 3: Configurar várias configuraçõ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 para o qual todas as implantações pendentes com um prazo neste momento também serão instaladas. Use esse parâmetro com o parâmetro EnforceMandatory. Você pode inserir um valor de 1 a 23 horas e de 1 a 365 dias. Por padrão, essa configuração é configurada por sete dias. Use o parâmetro TimeUnit para especificar horas ou dias.

Type:Int32
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-DefaultSetting

Adicione esse parâmetro para configurar as configurações de atualização de software nas configurações padrão do cliente.

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

-DeltaDownloadPort

Use esse parâmetro para configurar a porta de rede que os clientes usam para receber solicitações de conteúdo delta. Use o parâmetro EnableDeltaDownload para habilitar o comportamento. O valor padrão é 8005.

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

-DeploymentEvaluationSchedule

Especifique com que frequência o agente cliente de atualização de software reavalia atualizações de software para o status de instalação em computadores cliente do Configuration Manager. Para criar um novo token de agendamento, use o cmdlet New-CMSchedule.

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

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

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

-EnableDeltaDownload

De definir esse parâmetro $true para permitir que os clientes baixem conteúdo delta quando disponíveis. Para configurar a porta de rede, use o parâmetro DeltaDownloadPort.

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

-EnableDynamicUpdate

Aplica-se à versão 2010 e posterior. De definir esse parâmetro para $true habilitar a atualização dinâmica para Windows 10 de recursos. A atualização dinâmica instala pacotes de idiomas, recursos sob demanda, drivers e atualizações cumulativas durante Windows configuração. Ele direciona o cliente para baixar essas atualizações da Internet.

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

-EnableInstallation

Aplica-se à versão 2010 e posterior. De definir esse parâmetro para habilitar a instalação de atualizações de software na janela de manutenção "Todas as implantações" quando a janela de manutenção "Atualização de $true Software" estiver disponível.

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

-EnableThirdPartyUpdates

De definir esse parâmetro $true para habilitar atualizações de software de terceiros.

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

-EnableWsusCertPinning

Aplica-se à versão 2107 e posterior. Defina esse parâmetro para impor o pinamento de certificado $true TLS para Windows atualizar cliente para detectar atualizações.

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

-EnforceMandatory

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

Type:Boolean
Position:Named
Default value:None
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). Não é possível combiná-lo com DisableWildcardHandling.

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

-Habilitar

De definir esse parâmetro para $true habilitar atualizações de software em clientes.

Type:Boolean
Aliases:EnableSoftwareUpdatesOnClient
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Este cmdlet adiciona as configurações de atualização de software ao objeto de configurações do cliente especificado com esse parâmetro. Para obter esse objeto, use o cmdlet Get-CMClientSetting.

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

-Name

Este cmdlet adiciona as configurações de atualização de software ao objeto de configurações do cliente que esse parâmetro nomeia.

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

-Office365ManagementType

De definir esse parâmetro $true para habilitar o gerenciamento do agente Microsoft 365 Apps cliente e configurações de instalação.

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

-PassThru

Retorna um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

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

-ScanSchedule

Especifique com que frequência o agente cliente de atualizações de software inicia uma verificação de avaliação de conformidade. Esta verificação determina o estado das atualizações de software no cliente. Para criar um novo token de agendamento, use o cmdlet New-CMSchedule.

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

-ThreadPriority

Aplica-se à versão 2010 e posterior. Especifique uma prioridade de thread para Windows 10 de recursos.

  • Normal: Windows a Instalação usa mais recursos do sistema e atualizações mais rapidamente. Ele usa mais tempo de processador, portanto, o tempo total de instalação é menor, mas a paralisação do usuário é maior. Esse valor é o padrão.

  • Low: Você pode continuar a trabalhar no dispositivo enquanto ele baixa e atualiza em segundo plano. O tempo total de instalação é maior, mas a paralisação do usuário é menor. Talvez seja necessário aumentar o tempo máximo de uso da atualização para evitar um tempo de tempo de uso dessa opção.

Type:ThreadPriorityType
Accepted values:Normal, Low
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TimeUnit

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

Type:BatchingTimeoutType
Accepted values:Days, Hours
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object