Compartilhar via


Set-CMSoftwareUpdateAutoDeploymentRule

Modifique uma ADR (regra de implantação automática) 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 ADR (regra de implantação automática) para atualizações de software. Para obter uma regra existente, use o cmdlet Get-CMSoftwareUpdateAutoDeploymentRule .

Configuration Manager usa regras para gerenciar a implantação automática de atualizações de software. Quando uma regra é executada, Configuration Manager adiciona atualizações que se qualificam para a regra a um grupo de atualização de software. O servidor Configuration Manager baixa arquivos de conteúdo e os copia para pontos de distribuição e atualiza computadores cliente.

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

Esse comando modifica a regra de implantação automática chamada DeploymentRule07. Ele especifica o português (Brasil) para os arquivos de atualização de software do Windows que o site baixa. 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 implantação

Os exemplos a seguir demonstram métodos diferentes para configurar o pacote de implantaçã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 uma ADR para vários idiomas

Este exemplo altera a ADR para usar os critérios de idioma para três idiomas: inglês, húngaro e chinês (simplificado, PRC). Ele também muda para esses idiomas para o Windows e Office 365 atualizar binários a serem baixados.

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 é adicionada a um grupo de atualizações existente. Se esse valor for $True, sempre que a regra for executada e encontrar novas atualizações, ela as adicionará a um grupo de atualizações existente. Se esse valor for $False, ele criará um novo grupo de atualizações. Especifique o grupo de atualizações existente ou atribua um nome para o novo grupo de atualizações usando 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 deslocamento inteiro de um prazo de implantação de atualização. A regra usa esse valor para especificar quando a regra gera alertas. Especifique uma unidade de tempo usando 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 um computador deve ser reiniciado se a implantação de atualização ocorrer fora de uma janela de manutenção. Uma janela de manutenção é um período de tempo especificado usado para manutenção e atualizações do computador.

  • Se esse valor for $True, Configuration Manager reiniciará o computador, se necessário, para concluir a atualização.
  • Se esse valor for $False, Configuration Manager não reiniciará 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 implantação da atualização ocorre mesmo se agendada fora de uma janela de manutenção. Uma janela de manutenção é um período de tempo especificado usado para manutenção e atualizações do computador.

  • Se esse valor for $True, Configuration Manager implantará a atualização até mesmo a hora agendada fica fora da janela de serviço.
  • Se esse valor for $False, Configuration Manager não implantará a atualização fora da janela de serviço. Ele aguarda até que possa ser implantado em uma 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 os clientes podem baixar conteúdo em uma conexão de Internet limitada 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

Use esse parâmetro para definir o filtro de propriedade Arquitetura na página software Atualizações 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 de caracteres, para atualizações de software. A regra adiciona atualizações de software que têm IDs de artigo que atendem aos 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 essa regra implanta atualizações assim que as atualizações ficam disponíveis. Se você selecionar um valor de $False, use os parâmetros -AvailableTime e -AvailableTimeUnit para especificar quanto tempo após a regra for executada para implantar 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 inteiro. Configuration Manager implanta as atualizações muito depois da execução da regra. Especifique uma unidade de tempo usando 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 de caracteres, para atualizações de software. A regra adiciona atualizações de software que têm IDs de boletim que atendem aos 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

Essa propriedade é reservada para uso futuro.

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 implantaçã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

Use esse parâmetro para definir o filtro de propriedade Tamanho do Conteúdo (KB) na página Software Atualizações 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 severidade personalizados para atualizações de software. A regra adiciona atualizações de software que têm níveis de severidade personalizados que atendem aos 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 revisada para atualizações de software. A regra adiciona atualizações de software que têm uma data que atende aos 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 deve impor o prazo assim que a regra for executada. Se você especificar um valor de $False, use 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, 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 inteiro. O prazo para atualizações é tão longo após a execução da regra. Especifique uma unidade de tempo usando 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

Use esse parâmetro para definir o pacote de implantação para a regra de implantaçã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

Use esse parâmetro para definir o pacote de implantação para a regra de implantaçã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 implanta atualizações sem licenças.

  • Se você especificar um valor de $True, Configuration Manager implantará todas as atualizações para essa regra e aprovará quaisquer contratos de licença.
  • Se esse valor for $False, Configuration Manager implantará 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 da regra de implantaçã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 desabilitar alertas do System Center Operations Manager durante 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

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você 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 baixam atualizações de software da Internet. Se você especificar um valor de $False, especifique um local alternativo em que os computadores podem baixar atualizações usando 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 baixam conteúdo do Microsoft Update se esse conteúdo não estiver disponível em um ponto de distribuição preferencial do ponto de distribuição remota.

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 implantação automática está habilitada depois de criá-la.

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 é possível habilitar a implantação de software para o grupo de atualização de software associado após a execução dessa regra. Se esse valor for $False, implante 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

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você 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 de 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 deve 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 deve gerar um alerta para implantação bem-sucedida.

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 implantação automática para configurar. Esse 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 implantação automática. Para obter um objeto ADR, use 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 caracteres de critérios de linguagem para atualizações de software. A regra adiciona atualizações de software que têm idiomas que atendem aos critérios especificados ao grupo de atualização de software.

Use o formato do idioma conforme exibido no console. Por exemplo:

  • English
  • Hungarian
  • Chinese (Simplified, PRC)

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

Dica

Se você executar esse cmdlet em um computador em que o Windows tem uma interface do usuário localizada, os nomes do idioma poderão ser diferentes. Por exemplo, a versão em inglês do Windows usa "Danish", mas a versão dinamarquesa do Windows usa "Dansk".

Esse parâmetro substitui todos os valores existentes com os valores especificados.

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 cadeia de caracteres de idiomas. Os clientes baixam atualizações de software disponíveis nos idiomas especificados e atualizações neutras no idioma.

Use o formato do idioma conforme exibido no console. Por exemplo:

  • English
  • Hungarian
  • Chinese (Simplified, PRC)

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

Dica

Se você executar esse cmdlet em um computador em que o Windows tem uma interface do usuário localizada, os nomes do idioma poderão ser diferentes. Por exemplo, a versão em inglês do Windows usa "Danish", mas a versão dinamarquesa do Windows usa "Dansk".

Esse parâmetro substitui todos os valores existentes com os valores especificados.

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

-Location

Especifica um local em sua rede em que os computadores podem baixar atualizações de software. Para usar esse local, especifique um valor do $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 têm 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 implantaçã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 não é possível proibir a instalação de atualizações em sistemas remotos.

  • Se você especificar um valor de , se o cliente estiver dentro de um limite de rede lento ou não confiável ou quando o cliente usar um local de $Trueorigem de fallback para conteúdo, Configuration Manager não instalará atualizações de software.
  • Se você especificar um valor de $False, a instalação continuará.
Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NoInstallOnUnprotected

Indica se não é possível proibir a instalação de atualizações em sistemas desprotegidos.

  • Se você especificar um valor de , se as atualizações de $Truesoftware não estiverem disponíveis em nenhum ponto de distribuição preferencial, Configuration Manager não baixará e instalará atualizações de software.
  • Se você especificar um valor de $False, a instalação continuará.
Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-O365LanguageSelection

Use esse parâmetro para definir a seleção de idioma do Office 365 Client Update. Especifique uma matriz de cadeia de caracteres de idiomas. Os clientes baixam atualizações de software disponíveis nos idiomas especificados e atualizações neutras no idioma.

Use o formato do idioma conforme exibido no console para a seleção de idiomas Windows Update. Esse formato é o mesmo que o com o parâmetro LanguageSelection . Por exemplo:

  • English
  • Hungarian
  • Chinese (Simplified, PRC)

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

Dica

Se você executar esse cmdlet em um computador em que o Windows tem uma interface do usuário localizada, os nomes do idioma poderão ser diferentes. Por exemplo, a versão em inglês do Windows usa "Danish", mas a versão dinamarquesa do Windows usa "Dansk".

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

A partir da versão 2103, você precisa especificar um idioma com um nome de país/região. Essa alteração alinha esse parâmetro com as opções no console Configuration Manager. Por exemplo, -O365LanguageSelection "English (United States)"

Esse parâmetro substitui todos os valores existentes com os valores especificados.

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

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 de caracteres, para atualizações de software. A regra adiciona atualizações de software para produtos que atendem aos 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 de caracteres, para atualizações de software. A regra adiciona atualizações de software identificadas pelo necessário que atendem aos 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

Use esse parâmetro para definir a seguinte opção na página Experiência do Usuário das configurações de implantação do ADR: se qualquer atualização nesta implantação exigir uma reinicialização do sistema, execute o ciclo de avaliação de implantação de atualizações após a reinicialização.

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 recorrente para quando o site avaliar a ADR.

Se você especificar RunTheRuleOnSchedule, especifique uma agenda usando o parâmetro -Agendar .

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 agenda para a implantação. Para obter um objeto de agendamento, use o cmdlet New-CMSchedule . Especifique um cronograma para esse parâmetro se você especificar um valor do 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 é necessário enviar um pacote de despertar para computadores antes do início da implantação.

  • Se esse valor for $True, Configuration Manager acordará um computador do sono.
  • Se esse valor for $False, ele não acordará os computadores do sono.

Para que os computadores ativem, primeiro você deve configurar o Wake On 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 severidade 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

Use esse parâmetro para definir a seguinte opção na página Agenda de Implantação das configurações de implantação do ADR: atrasar a aplicação dessa implantação de acordo com as preferências do usuário, até o período de carência definido nas configuraçõ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 porcentagem para a conformidade do cliente como um inteiro de 0 a 99. Se a conformidade estiver abaixo desse percentual, Configuration Manager produzirá 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ídas 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 é necessário suprimir uma atualização necessária para um servidor. Algumas atualizações de software exigem uma reinicialização 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 é necessário suprimir uma atualização necessária para uma estação de trabalho. Algumas atualizações de software exigem uma reinicialização 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 de caracteres, para atualizações de software. A regra adiciona atualizações de software que têm títulos que atendem aos 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 de caracteres, para atualizações de software. A regra adiciona atualizações de software que têm classificações de atualização que atendem aos 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 de caracteres, para atualizações de software. A regra adiciona atualizações de software que têm descrições de atualização que atendem aos 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 usar o Windows BranchCache para essa implantação de atualização. Se você especificar um valor de $True, os clientes compartilharão 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 usuário.

  • DisplayAll: exiba no Centro de Software e mostre todas as notificações.
  • DisplaySoftwareCenterOnly: exiba no Centro de Software e mostre apenas notificações de reinicializações do computador.
  • HideAll: ocultar no Centro de Software e 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 usar o UTC (Tempo Universal Coordenado).

  • Se esse valor for $True, Configuration Manager usará UTC para essa implantação.
  • Se esse valor for $False, Configuration Manager usará 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 detalhes que você deseja que os clientes reportem para implantações que essa regra cria.

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 é necessário habilitar filtros de gravação para dispositivos inseridos.

  • Para um valor de $True, o dispositivo confirma alterações durante uma janela de manutenção. Essa ação requer uma reinicialização.
  • Para um valor de $False, o dispositivo salva alterações em uma sobreposição e as confirma posteriormente.
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