New-CMSoftwareUpdateAutoDeploymentRule
Crie uma regra de implementação automática (ADR) para atualizações de software.
Sintaxe
New-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[]>]
-Collection <IResultObject>
[-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>]
[-GenerateFailureAlert <Boolean>]
[-GenerateOperationManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-IsServicingPlan]
[-Language <String[]>]
[-LanguageSelection <String[]>]
[-Location <String>]
[-MicrosoftAsVendor <Boolean>]
-Name <String>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-O365LanguageSelection <String[]>]
[-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>] New-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[]>]
-CollectionId <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>]
[-GenerateFailureAlert <Boolean>]
[-GenerateOperationManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-IsServicingPlan]
[-Language <String[]>]
[-LanguageSelection <String[]>]
[-Location <String>]
[-MicrosoftAsVendor <Boolean>]
-Name <String>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-O365LanguageSelection <String[]>]
[-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>] New-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>]
[-GenerateFailureAlert <Boolean>]
[-GenerateOperationManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-IsServicingPlan]
[-Language <String[]>]
[-LanguageSelection <String[]>]
[-Location <String>]
[-MicrosoftAsVendor <Boolean>]
-Name <String>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-O365LanguageSelection <String[]>]
[-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 New-CMSoftwareUpdateAutoDeploymentRule cria uma regra de implementação automática (ADR) para 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. Para obter mais informações, veja Implementar automaticamente atualizações de software.
Observação
Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.
Exemplos
Exemplo 1: Criar um ADR básico
Este comando cria uma regra de implementação denominada DeploymentRule07 para a coleção denominada Desktops e o pacote de implementação com o nome Updates123. A regra implementa atualizações que têm um ID de artigo que contém 117.
New-CMSoftwareUpdateAutoDeploymentRule -CollectionName "Desktops" -DeploymentPackageName "Updates123" -Name "DeploymentRule07" -ArticleId "117"Exemplo 2: Criar um ADR que utiliza uma agenda e outras propriedades
Este exemplo cria uma regra de implementação automática que utiliza uma agenda definida. A implementação ocorre de acordo com a agenda.
O primeiro comando cria uma agenda para quarta-feira e armazena o objeto schedule na variável $Schedule . Para obter mais informações, veja New-CMSchedule.
O segundo comando cria uma regra de implementação automática para atualizações que utilizam o objeto schedule armazenado na variável . Este comando especifica valores para muitos parâmetros.
$Schedule = New-CMSchedule -DayOfWeek Wednesday
New-CMSoftwareUpdateAutoDeploymentRule -CollectionName "Laptops" -DeploymentPackageName "Updates235" -Name "DeploymentRule22" -AddToExistingSoftwareUpdateGroup $False -AlertTime 4 -AlertTimeUnit Weeks -AllowRestart $True -AllowSoftwareInstallationOutsideMaintenanceWindow $True -AllowUseMeteredNetwork $True -ArticleId "test" -AvailableImmediately $False -AvailableTime 5 -AvailableTimeUnit Months -CustomSeverity Critical -DateReleasedOrRevised Last1day -DeadlineImmediately $False -DeadlineTime $True -DeadlineTimeUnit Hours -DeployWithoutLicense $True -Description "Standard updates for our laptop systems." -DisableOperationManager $True -DownloadFromInternet $False -DownloadFromMicrosoftUpdate $True -EnabledAfterCreate $False -GenerateOperationManagerAlert $True -GenerateSuccessAlert $True -Location "\\k\aS_O15_Client_Dev_1" -NoInstallOnRemote $False -NoInstallOnUnprotected $True -RunType RunTheRuleOnSchedule -Schedule $Schedule -SendWakeUpPacket $True -SuccessPercent 99 -Superseded $True -SuppressRestartServer $True -SuppressRestartWorkstation $True -UpdateClassification "Critical Updates" -UseBranchCache $False -UserNotification DisplayAll -UseUtc $True -VerboseLevel AllMessages -WriteFilterHandling $TrueExemplo 3: Criar um ADR para vários idiomas
Este exemplo cria um ADR que adiciona os critérios de Idioma para três idiomas: inglês, húngaro e chinês (simplificado, PRC). Também adiciona estes idiomas para transferir os binários de atualização do Windows e do Office 365. Esta regra de exemplo está desativada por predefinição.
New-CMSoftwareUpdateAutoDeploymentRule -Name "Multi-language ADR" -CollectionId "XYZ0003F" -Language "English","Hungarian","Chinese (Simplified, PRC)" -Enable $false -EnabledAfterCreate $false -RunType DoNotRunThisRuleAutomatically -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ção de software 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 |
-Collection
Especifique um objeto de coleção como destino para a regra de implementação automática.
| Tipo: | IResultObject |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CollectionId
Especifique um ID de coleção como destino para a regra de implementação automática.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| 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: | True |
| 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 especificar um objeto para o pacote de implementação utilizar com esta regra de implementação automática. Para não exigir um pacote, defina o valor como $null.
| Tipo: | IResultObject |
| Aliases: | InputObject |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-DeploymentPackageName
Especifique o nome do pacote de implementação a utilizar com esta regra de implementação automática. 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 |
-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 |
-IsServicingPlan
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| 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:
EnglishHungarianChinese (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".
| 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:
EnglishHungarianChinese (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".
| 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 |
-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:
EnglishHungarianChinese (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)"
| Tipo: | String[] |
| 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.
A partir da versão 2107, quando existem vários produtos com o mesmo nome, seleciona-os a todos.
| Tipo: | String[] |
| 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
IResultObject
Observações
Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_AutoDeployment classe WMI de servidor.