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
$True
origem 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
$True
software 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
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de