Set-CMSoftwareUpdateAutoDeploymentRule

Modifique uma regra de implementação automática (ADR) para atualizações de software.

Sintaxe

Set-CMSoftwareUpdateAutoDeploymentRule
   [-AddToExistingSoftwareUpdateGroup <Boolean>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-AllowRestart <Boolean>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-Architecture <ArchitectureType[]>]
   [-ArticleId <String[]>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-BulletinId <String[]>]
   [-CMTag <CMTagTypes[]>]
   [-CollectionName <String>]
   [-ContentSize <String[]>]
   [-CustomSeverity <SeverityType[]>]
   [-DateReleasedOrRevised <DateReleasedOrRevisedType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-DeploymentPackage <IResultObject>]
   [-DeploymentPackageName <String>]
   [-DeploymentRing <DeploymentRing>]
   [-DeployWithoutLicense <Boolean>]
   [-Description <String>]
   [-DisableOperationManager <Boolean>]
   [-DownloadFromInternet <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-Enable <Boolean>]
   [-EnabledAfterCreate <Boolean>]
   [-Force]
   [-GenerateFailureAlert <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   [-Language <String[]>]
   [-LanguageSelection <String[]>]
   [-Location <String>]
   [-MicrosoftAsVendor <Boolean>]
   -Name <String>
   [-NewName <String>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-O365LanguageSelection <String[]>]
   [-PassThru]
   [-Product <String[]>]
   [-Required <String[]>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-SendWakeupPacket <Boolean>]
   [-Severity <SeverityType[]>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SuccessPercentage <Int32>]
   [-Superseded <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-Title <String[]>]
   [-UpdateClassification <String[]>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-UpdateDescription <String[]>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-UseUtc <Boolean>]
   [-Vendor <String[]>]
   [-VerboseLevel <VerboseLevelType>]
   [-WriteFilterHandling <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMSoftwareUpdateAutoDeploymentRule
   [-AddToExistingSoftwareUpdateGroup <Boolean>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-AllowRestart <Boolean>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-Architecture <ArchitectureType[]>]
   [-ArticleId <String[]>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-BulletinId <String[]>]
   [-CMTag <CMTagTypes[]>]
   [-CollectionName <String>]
   [-ContentSize <String[]>]
   [-CustomSeverity <SeverityType[]>]
   [-DateReleasedOrRevised <DateReleasedOrRevisedType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-DeploymentPackage <IResultObject>]
   [-DeploymentPackageName <String>]
   [-DeploymentRing <DeploymentRing>]
   [-DeployWithoutLicense <Boolean>]
   [-Description <String>]
   [-DisableOperationManager <Boolean>]
   [-DownloadFromInternet <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-Enable <Boolean>]
   [-EnabledAfterCreate <Boolean>]
   [-Force]
   [-GenerateFailureAlert <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   -Id <String[]>
   [-Language <String[]>]
   [-LanguageSelection <String[]>]
   [-Location <String>]
   [-MicrosoftAsVendor <Boolean>]
   [-NewName <String>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-O365LanguageSelection <String[]>]
   [-PassThru]
   [-Product <String[]>]
   [-Required <String[]>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-SendWakeupPacket <Boolean>]
   [-Severity <SeverityType[]>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SuccessPercentage <Int32>]
   [-Superseded <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-Title <String[]>]
   [-UpdateClassification <String[]>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-UpdateDescription <String[]>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-UseUtc <Boolean>]
   [-Vendor <String[]>]
   [-VerboseLevel <VerboseLevelType>]
   [-WriteFilterHandling <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMSoftwareUpdateAutoDeploymentRule
   [-AddToExistingSoftwareUpdateGroup <Boolean>]
   [-AlertTime <Int32>]
   [-AlertTimeUnit <TimeUnitType>]
   [-AllowRestart <Boolean>]
   [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
   [-AllowUseMeteredNetwork <Boolean>]
   [-Architecture <ArchitectureType[]>]
   [-ArticleId <String[]>]
   [-AvailableImmediately <Boolean>]
   [-AvailableTime <Int32>]
   [-AvailableTimeUnit <TimeUnitType>]
   [-BulletinId <String[]>]
   [-CMTag <CMTagTypes[]>]
   [-CollectionName <String>]
   [-ContentSize <String[]>]
   [-CustomSeverity <SeverityType[]>]
   [-DateReleasedOrRevised <DateReleasedOrRevisedType>]
   [-DeadlineImmediately <Boolean>]
   [-DeadlineTime <Int32>]
   [-DeadlineTimeUnit <TimeUnitType>]
   [-DeploymentPackage <IResultObject>]
   [-DeploymentPackageName <String>]
   [-DeploymentRing <DeploymentRing>]
   [-DeployWithoutLicense <Boolean>]
   [-Description <String>]
   [-DisableOperationManager <Boolean>]
   [-DownloadFromInternet <Boolean>]
   [-DownloadFromMicrosoftUpdate <Boolean>]
   [-Enable <Boolean>]
   [-EnabledAfterCreate <Boolean>]
   [-Force]
   [-GenerateFailureAlert <Boolean>]
   [-GenerateOperationManagerAlert <Boolean>]
   [-GenerateSuccessAlert <Boolean>]
   -InputObject <IResultObject>
   [-Language <String[]>]
   [-LanguageSelection <String[]>]
   [-Location <String>]
   [-MicrosoftAsVendor <Boolean>]
   [-NewName <String>]
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-O365LanguageSelection <String[]>]
   [-PassThru]
   [-Product <String[]>]
   [-Required <String[]>]
   [-RequirePostRebootFullScan <Boolean>]
   [-RunType <RunType>]
   [-Schedule <IResultObject>]
   [-SendWakeupPacket <Boolean>]
   [-Severity <SeverityType[]>]
   [-SoftDeadlineEnabled <Boolean>]
   [-SuccessPercentage <Int32>]
   [-Superseded <Boolean>]
   [-SuppressRestartServer <Boolean>]
   [-SuppressRestartWorkstation <Boolean>]
   [-Title <String[]>]
   [-UpdateClassification <String[]>]
   [-UpdateDeploymentWaitDay <Int32>]
   [-UpdateDescription <String[]>]
   [-UseBranchCache <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-UseUtc <Boolean>]
   [-Vendor <String[]>]
   [-VerboseLevel <VerboseLevelType>]
   [-WriteFilterHandling <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-CMSoftwareUpdateAutoDeploymentRule modifica uma regra de implementação automática (ADR) para atualizações de software. Para obter uma regra existente, utilize o cmdlet Get-CMSoftwareUpdateAutoDeploymentRule .

O Configuration Manager utiliza regras para gerir a implementação automática de atualizações de software. Quando uma regra é executada, o Configuration Manager adiciona atualizações que se qualificam para a regra a um grupo de atualização de software. O servidor do Configuration Manager transfere ficheiros de conteúdo e copia-os para pontos de distribuição e, em seguida, atualiza os computadores cliente.

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: Modificar a seleção de idioma e o nome de uma regra

Este comando modifica a regra de implementação automática denominada DeploymentRule07. Especifica português (Brasil) para os ficheiros de atualização de software do Windows que o site transfere. O comando também altera o nome da regra para DeploymentRule07Revised.

Set-CMSoftwareUpdateAutoDeploymentRule -Name "DeploymentRule07" -NewName "DeploymentRule07Revised" -Description "ADR downloads Portuguese (Brazil) files." -LanguageSelection "Portuguese (Brazil)"

Exemplo 2: Configurar o pacote de implementação

Os exemplos seguintes demonstram diferentes métodos para configurar o pacote de implementação.

Set-CMSoftwareUpdateAutoDeploymentRule -Name $ReferenceADRName -DeploymentPackageName $null
Set-CMSoftwareUpdateAutoDeploymentRule -Name $ReferenceADRName -DeploymentPackageName $packageName
Set-CMSoftwareUpdateAutoDeploymentRule -Name $ReferenceADRName -DeploymentPackage $null
Set-CMSoftwareUpdateAutoDeploymentRule -Name $ReferenceADRName -DeploymentPackage $package

Exemplo 3: Modificar um ADR para vários idiomas

Este exemplo altera o ADR para utilizar os critérios de Idioma para três idiomas: inglês, húngaro e chinês (simplificado, PRC). Também muda para estes idiomas para transferir os binários de atualização do Windows e do Office 365.

Set-CMSoftwareUpdateAutoDeploymentRule -Name "Multi-language ADR" -Language "English","Hungarian","Chinese (Simplified, PRC)" -LanguageSelection "English","Hungarian","Chinese (Simplified, PRC)" -O365LanguageSelection "English (United States)","Hungarian (Hungary)","Chinese (Simplified, PRC)"

Parâmetros

-AddToExistingSoftwareUpdateGroup

Indica se a regra adiciona a um grupo de atualizações existente. Se este valor for $True, sempre que a regra for executada e encontrar novas atualizações, adiciona-as a um grupo de atualizações existente. Se este valor for $False, cria um novo grupo de atualizações. Especifique o grupo de atualizações existente ou atribua um nome para o novo grupo de atualizações com o parâmetro DeploymentPackageName .

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

-AlertTime

Especifica um desvio de número inteiro a partir de um prazo de implementação de atualização. A regra utiliza este valor para especificar quando a regra gera alertas. Especifique uma unidade de tempo com o parâmetro -AlertTimeUnit .

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

-AlertTimeUnit

Especifica uma unidade de tempo para o parâmetro -AlertTime .

Tipo:TimeUnitType
Valores aceitos:Hours, Days, Weeks, Months
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AllowRestart

Indica se pretende permitir que um computador reinicie se a implementação da atualização ocorrer fora de uma janela de manutenção. Uma janela de manutenção é um período de tempo especificado utilizado para manutenção e atualizações do computador.

  • Se este valor for $True, o Configuration Manager reinicia o computador, se necessário, para concluir a atualização.
  • Se este valor for $False, o Configuration Manager não reinicia o computador.
Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AllowSoftwareInstallationOutsideMaintenanceWindow

Indica se a implementação da atualização ocorre mesmo que seja agendada fora de uma janela de manutenção. Uma janela de manutenção é um período de tempo especificado utilizado para manutenção e atualizações do computador.

  • Se este valor for $True, o Configuration Manager implementa a atualização, mesmo que a hora agendada fique fora da janela do serviço.
  • Se este valor for $False, o Configuration Manager não implementa a atualização fora da janela do serviço. Aguarda até poder ser implementado numa janela de serviço.
Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AllowUseMeteredNetwork

Indica se pretende permitir que os clientes transfiram conteúdo através de uma ligação à Internet com tráfego limitado após o prazo, o que pode incorrer em despesas adicionais.

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

-Architecture

Utilize este parâmetro para definir o filtro de propriedade Arquitetura na página Atualizações de Software das propriedades do ADR.

Tipo:ArchitectureType[]
Aliases:Architectures
Valores aceitos:Arm64, Itanium, X64, X86
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ArticleId

Especifica uma matriz de critérios, como cadeias, para atualizações de software. A regra adiciona atualizações de software que têm IDs de artigo que cumprem critérios especificados ao grupo de atualização de software.

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

-AvailableImmediately

Indica se esta regra implementa atualizações assim que as atualizações ficam disponíveis. Se selecionar um valor de $False, utilize os parâmetros -AvailableTime e -AvailableTimeUnit para especificar quanto tempo após a execução da regra para implementar as atualizações.

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

-AvailableTime

Especifica um período de tempo como um número inteiro. O Configuration Manager implementa as atualizações tanto tempo depois de a regra ser executada. Especifique uma unidade de tempo com o parâmetro -AvailableTimeUnit .

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

-AvailableTimeUnit

Especifica uma unidade de tempo para o parâmetro -AvailableTime .

Tipo:TimeUnitType
Valores aceitos:Hours, Days, Weeks, Months
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BulletinId

Especifica uma matriz de critérios, como cadeias, para atualizações de software. A regra adiciona atualizações de software que têm IDs de boletim que cumprem critérios especificados ao grupo de atualização de software.

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

-CMTag

Esta propriedade está reservada para utilização futura.

Tipo:CMTagTypes[]
Valores aceitos:None, UUP
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionName

Especifique um nome de coleção como o destino da regra de implementação automática.

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:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ContentSize

Utilize este parâmetro para definir o filtro de propriedade Tamanho do Conteúdo (KB) na página Atualizações de Software das propriedades do ADR.

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

-CustomSeverity

Especifica uma matriz de tipos de gravidade personalizados para atualizações de software. A regra adiciona atualizações de software que têm níveis de gravidade personalizados que cumprem os critérios especificados ao grupo de atualização de software.

Tipo:SeverityType[]
Valores aceitos:None, Low, Moderate, Important, Critical
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DateReleasedOrRevised

Especifica uma data lançada ou revista para atualizações de software. A regra adiciona atualizações de software que têm uma data que cumpre os critérios especificados ao grupo de atualização de software.

Tipo:DateReleasedOrRevisedType
Valores aceitos:Any, Last1Hour, LastHour, Last2Hours, Last3Hours, Last4Hours, Last8Hours, Last12Hours, Last16Hours, Last20Hours, Last1Day, LastDay, Last2Days, Last3Days, Last4Days, Last5Days, Last6Days, Last7Days, Last14Days, Last21Days, Last28Days, LastMonth, Last1Month, Last2Months, Last3Months, Last4Months, Last5Months, Last6Months, Last7Months, Last8Months, Last9Months, Last10Months, Last11Months, Last1Year, LastYear, Last12Months
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeadlineImmediately

Indica se pretende impor o prazo assim que a regra for executada. Se especificar um valor de $False, utilize os parâmetros -DeadlineTime e -DeadlineTimeUnit para especificar quanto tempo após a execução da regra para definir o prazo. Após o prazo, o Configuration Manager instala as atualizações necessárias.

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

-DeadlineTime

Especifica um período de tempo como um número inteiro. O prazo para atualizações é este longo após a execução da regra. Especifique uma unidade de tempo com o parâmetro -DeadlineTimeUnit .

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

-DeadlineTimeUnit

Especifica uma unidade de tempo para o parâmetro -DeadlineTime .

Tipo:TimeUnitType
Valores aceitos:Hours, Days, Weeks, Months
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeploymentPackage

Utilize este parâmetro para definir o pacote de implementação para a regra de implementação automática de atualização de software existente. Para não exigir um pacote, defina o valor como $null.

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

-DeploymentPackageName

Utilize este parâmetro para definir o pacote de implementação para a regra de implementação automática de atualização de software existente. Para não exigir um pacote, defina o valor como $null.

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

-DeploymentRing

Tipo:DeploymentRing
Valores aceitos:CB, Release, BusinessMainstream, Cbb, Ltsb
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeployWithoutLicense

Indica se a regra implementa atualizações sem licenças.

  • Se especificar um valor de $True, o Configuration Manager implementa todas as atualizações para esta regra e aprova quaisquer contratos de licença.
  • Se este valor for $False, o Configuration Manager implementa apenas atualizações que não incluem uma licença ou para as quais o contrato de licença foi aprovado.
Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifica uma descrição para a regra de implementação automática para atualizações de software.

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

-DisableOperationManager

Indica se deve desativar os alertas do System Center Operations Manager durante as atualizações de software.

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

-DownloadFromInternet

Indica se os computadores transferem atualizações de software a partir da Internet. Se especificar um valor de $False, especifique uma localização alternativa onde os computadores possam transferir atualizações com o parâmetro -Location .

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

-DownloadFromMicrosoftUpdate

Indica se os computadores transferem conteúdo do Microsoft Update se esse conteúdo não estiver disponível num ponto de distribuição preferencial do ponto de distribuição remoto.

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

-Enable

Especifique se a regra de implementação automática está ativada depois de a criar.

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

-EnabledAfterCreate

Indica se pretende ativar a implementação de software para o grupo de atualização de software associado após a execução desta regra. Se este valor for $False, implemente o grupo de atualização de software manualmente.

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

-Force

Execute o comando sem pedir confirmação.

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

-GenerateFailureAlert

Se a regra falhar, crie um alerta do Configuration Manager.

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

-GenerateOperationManagerAlert

Indica se pretende gerar alertas do Operations Manager durante uma atualização de software.

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

-GenerateSuccessAlert

Indica se pretende gerar um alerta para uma implementação com êxito.

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

-Id

Especifique uma matriz de IDs de regra de implementação automática a configurar. Este valor é a propriedade AutoDeploymentID do objeto ADR.

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

-InputObject

Especifique um objeto de regra de implementação automática. Para obter um objeto ADR, utilize o cmdlet Get-CMSoftwareUpdateAutoDeploymentRule .

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

-Language

Especifique uma matriz de cadeia de critérios de linguagem para atualizações de software. A regra adiciona atualizações de software que têm idiomas que cumprem critérios especificados ao grupo de atualização de software.

Utilize o formato do idioma conforme apresentado na consola do . Por exemplo:

  • English
  • Hungarian
  • Chinese (Simplified, PRC)

O formato da matriz de cadeia é: "English","Hungarian","Chinese (Simplified, PRC)"

Dica

Se executar este cmdlet num computador onde o Windows tem uma IU localizada, os nomes dos idiomas poderão ser diferentes. Por exemplo, a versão em inglês do Windows utiliza "Dinamarquês", mas a versão dinamarquesa do Windows utiliza "Dansk".

Este parâmetro substitui quaisquer valores existentes pelos valores que especificar.

Tipo:String[]
Aliases:Languages, UpdateLocales, UpdateLocale
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LanguageSelection

Especifique uma matriz de cadeias de idiomas. Os clientes transferem atualizações de software disponíveis nos idiomas especificados e atualizações neutras em linguagem.

Utilize o formato do idioma conforme apresentado na consola do . Por exemplo:

  • English
  • Hungarian
  • Chinese (Simplified, PRC)

O formato da matriz de cadeia é: "English","Hungarian","Chinese (Simplified, PRC)"

Dica

Se executar este cmdlet num computador onde o Windows tem uma IU localizada, os nomes dos idiomas poderão ser diferentes. Por exemplo, a versão em inglês do Windows utiliza "Dinamarquês", mas a versão dinamarquesa do Windows utiliza "Dansk".

Este parâmetro substitui quaisquer valores existentes pelos valores que especificar.

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

-Location

Especifica uma localização na sua rede onde os computadores podem transferir atualizações de software. Para utilizar esta localização, especifique um valor de $False para o parâmetro -DownloadFromInternet .

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

-MicrosoftAsVendor

Indica se a regra inclui apenas atualizações que tenham a Microsoft como fornecedor.

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

-Name

Especifica um nome para a regra de implementação automática para atualizações de software.

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

-NewName

Especifique um novo nome para a ADR.

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

-NoInstallOnRemote

Indica se pretende não permitir a instalação de atualizações em sistemas remotos.

  • Se especificar um valor de , se o cliente estiver dentro de um limite de rede lento ou pouco fiável ou quando o cliente utilizar uma localização de $Trueorigem de contingência para conteúdo, o Configuration Manager não instala atualizações de software.
  • Se especificar um valor de $False, a instalação continua.
Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NoInstallOnUnprotected

Indica se pretende não permitir a instalação de atualizações em sistemas desprotegidos.

  • Se especificar um valor de , se as atualizações de $Truesoftware não estiverem disponíveis em quaisquer pontos de distribuição preferenciais, o Configuration Manager não transfere e instala atualizações de software.
  • Se especificar um valor de $False, a instalação continua.
Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-O365LanguageSelection

Utilize este parâmetro para definir a seleção de idioma de Atualização de Cliente do Office 365 . Especifique uma matriz de cadeias de idiomas. Os clientes transferem atualizações de software disponíveis nos idiomas especificados e atualizações neutras em linguagem.

Utilize o formato do idioma conforme apresentado na consola do para a seleção de idioma do Windows Update . Este formato é o mesmo que com o parâmetro LanguageSelection . Por exemplo:

  • English
  • Hungarian
  • Chinese (Simplified, PRC)

O formato da matriz de cadeia é: "English","Hungarian","Chinese (Simplified, PRC)"

Dica

Se executar este cmdlet num computador onde o Windows tem uma IU localizada, os nomes dos idiomas poderão ser diferentes. Por exemplo, a versão em inglês do Windows utiliza "Dinamarquês", mas a versão dinamarquesa do Windows utiliza "Dansk".

Atualmente, não pode especificar com este parâmetro todos os idiomas disponíveis na consola do Configuration Manager. Por exemplo, não pode especificar "Irlandês (Irlanda)" ou "Maltês (Malta)".

A partir da versão 2103, tem de especificar um idioma com um nome de país/região. Esta alteração alinha este parâmetro com as opções na consola do Configuration Manager. Por exemplo, -O365LanguageSelection "English (United States)"

Este parâmetro substitui quaisquer valores existentes pelos valores que especificar.

Tipo:String[]
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

-Product

Especifica uma matriz de critérios, como cadeias, para atualizações de software. A regra adiciona atualizações de software para produtos que cumprem critérios especificados ao grupo de atualização de software.

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

-Required

Especifica uma matriz de critérios, como cadeias, para atualizações de software. A regra adiciona atualizações de software identificadas pelo necessário que cumprem os critérios especificados ao grupo de atualização de software.

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

-RequirePostRebootFullScan

Utilize este parâmetro para definir a seguinte opção na página Experiência de Utilizador das definições de implementação do ADR: se alguma atualização nesta implementação exigir um reinício do sistema, execute o ciclo de avaliação da implementação de atualizações após o reinício.

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

-RunType

Especifique a agenda periódica para quando o site avaliar a ADR.

Se especificar , especifique RunTheRuleOnScheduleuma agenda utilizando o parâmetro -Schedule .

Tipo:RunType
Valores aceitos:DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Schedule

Especifica um objeto de agendamento para a implementação. Para obter um objeto de agendamento, utilize o cmdlet New-CMSchedule . Especifique uma agenda para este parâmetro se especificar um valor de RunTheRuleOnSchedule para o parâmetro -RunType .

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

-SendWakeupPacket

Indica se pretende enviar um pacote de reativação para os computadores antes do início da implementação.

  • Se este valor for $True, o Configuration Manager reativa um computador do modo de suspensão.
  • Se este valor for $False, não reativa os computadores do modo de suspensão.

Para que os computadores reativam, primeiro tem de configurar a Reativação por LAN.

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

-Severity

Especifica uma matriz de níveis de gravidade para atualizações de software. A regra adiciona atualizações de software para tipos de gravidade especificados ao grupo de atualização de software.

Tipo:SeverityType[]
Aliases:Severities
Valores aceitos:None, Low, Moderate, Important, Critical
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SoftDeadlineEnabled

Utilize este parâmetro para definir a seguinte opção na página Agenda de Implementação das definições de implementação do ADR: Atrasar a imposição desta implementação de acordo com as preferências do utilizador, até ao período de tolerância definido nas definições do cliente.

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

-SuccessPercentage

Especifica uma percentagem para a conformidade do cliente como um número inteiro de 0 a 99. Se a conformidade ficar abaixo desta percentagem, o Configuration Manager produz alertas opcionais.

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

-Superseded

Indica se a regra adiciona atualizações substituídos por outras atualizações.

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

-SuppressRestartServer

Indica se pretende suprimir uma atualização necessária para um servidor. Algumas atualizações de software requerem um reinício do sistema para concluir o processo de instalação.

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

-SuppressRestartWorkstation

Indica se pretende suprimir uma atualização necessária para uma estação de trabalho. Algumas atualizações de software requerem um reinício do sistema para concluir o processo de instalação.

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

-Title

Especifica uma matriz de critérios, como cadeias, para atualizações de software. A regra adiciona atualizações de software que têm títulos que cumprem critérios especificados ao grupo de atualização de software.

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

-UpdateClassification

Especifica uma matriz de critérios, como cadeias, para atualizações de software. A regra adiciona atualizações de software que têm classificações de atualização que cumprem critérios especificados ao grupo de atualização de software.

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

-UpdateDeploymentWaitDay

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

-UpdateDescription

Especifica uma matriz de critérios, como cadeias, para atualizações de software. A regra adiciona atualizações de software que têm descrições de atualização que cumprem critérios especificados ao grupo de atualização de software.

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

-UseBranchCache

Indica se deve utilizar o Windows BranchCache para esta implementação de atualização. Se especificar um valor de $True, os clientes partilham conteúdo na mesma sub-rede.

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

-UserNotification

Especifica o tipo de notificação do utilizador.

  • DisplayAll: apresentar no Centro de Software e mostrar todas as notificações.
  • DisplaySoftwareCenterOnly: apresentar no Centro de Software e mostrar apenas notificações de reinícios do computador.
  • HideAll: oculte-se no Centro de Software e em todas as notificações.
Tipo:UserNotificationType
Valores aceitos:DisplayAll, DisplaySoftwareCenterOnly, HideAll
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UseUtc

Indica se deve utilizar a Hora Universal Coordenada (UTC).

  • Se este valor for $True, o Configuration Manager utiliza UTC para esta implementação.
  • Se este valor for $False, o Configuration Manager utiliza a hora local.
Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Vendor

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

-VerboseLevel

Especifica o nível de detalhe que pretende que os clientes reportem para implementações criadas por esta regra.

Tipo:VerboseLevelType
Valores aceitos:OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
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:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WriteFilterHandling

Indica se pretende ativar filtros de escrita para dispositivos incorporados.

  • Para um valor de $True, o dispositivo consolida as alterações durante uma janela de manutenção. Esta ação requer um reinício.
  • Para um valor de $False, o dispositivo guarda as alterações numa sobreposição e consolida-as mais tarde.
Tipo:Boolean
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