New-CMSoftwareUpdateAutoDeploymentRule
Crie uma ADR (regra de implantação automática) para atualizações de software.
Syntax
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 ADR (regra de implantação automática) para 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. Para obter mais informações, confira Implantar automaticamente atualizações de software.
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: criar uma ADR básica
Esse comando cria uma regra de implantação chamada DeploymentRule07 para a coleção chamada Desktops e o pacote de implantação chamado Updates123. A regra implanta atualizações que têm uma ID de artigo que contém 117.
New-CMSoftwareUpdateAutoDeploymentRule -CollectionName "Desktops" -DeploymentPackageName "Updates123" -Name "DeploymentRule07" -ArticleId "117"
Exemplo 2: criar uma ADR que usa um agendamento e outras propriedades
Este exemplo cria uma regra de implantação automática que usa um agendamento definido. A implantação ocorre de acordo com a agenda.
O primeiro comando cria uma agenda para quarta-feira e armazena o objeto de agendamento na variável $Schedule . Para obter mais informações, consulte New-CMSchedule.
O segundo comando cria uma regra de implantação automática para atualizações que usa o objeto de agendamento armazenado na variável. Esse 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 $True
Exemplo 3: criar uma ADR para vários idiomas
Este exemplo cria uma ADR que adiciona os critérios de idioma para três idiomas: inglês, húngaro e chinês (simplificado, PRC). Ele também adiciona esses idiomas para o Windows e Office 365 atualizar binários a serem baixados. Esta regra de exemplo é desabilitada por padrã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 é adicionada a um grupo de atualização de software 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 .
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AlertTimeUnit
Especifica uma unidade de tempo para o parâmetro -AlertTime .
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Architecture
Use esse parâmetro para definir o filtro de propriedade Arquitetura na página software Atualizações das propriedades do ADR.
Type: | ArchitectureType[] |
Aliases: | Architectures |
Accepted values: | Arm64, Itanium, X64, X86 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailableTimeUnit
Especifica uma unidade de tempo para o parâmetro -AvailableTime .
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CMTag
Essa propriedade é reservada para uso futuro.
Type: | CMTagTypes[] |
Accepted values: | None, UUP |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
Especifique um objeto de coleção como o destino da regra de implantação automática.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Especifique uma ID de coleção como o destino da regra de implantação automática.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Especifique um nome de coleção como o destino da regra de implantação automática.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String[] |
Aliases: | ContentSizes |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SeverityType[] |
Accepted values: | None, Low, Moderate, Important, Critical |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | DateReleasedOrRevisedType |
Accepted values: | 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 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineTimeUnit
Especifica uma unidade de tempo para o parâmetro -DeadlineTime .
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentPackage
Use esse parâmetro para especificar um objeto para o pacote de implantação a ser usado com essa regra de implantação automática. Para não exigir um pacote, defina o valor como $null
.
Type: | IResultObject |
Aliases: | InputObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DeploymentPackageName
Especifique o nome do pacote de implantação a ser usado com essa regra de implantação automática. Para não exigir um pacote, defina o valor como $null
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentRing
Type: | DeploymentRing |
Accepted values: | CB, Release, BusinessMainstream, Cbb, Ltsb |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifica uma descrição da regra de implantação automática para atualizações de software.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableOperationManager
Indica se deve desabilitar alertas do System Center Operations Manager durante atualizações de software.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Enable
Especifique se a regra de implantação automática está habilitada depois de criá-la.
Type: | Boolean |
Aliases: | Enabled, EnableDeployment |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Aliases: | EnableAfterCreate |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GenerateFailureAlert
Se a regra falhar, crie um alerta de Configuration Manager.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GenerateOperationManagerAlert
Indica se deve gerar alertas do Operations Manager durante uma atualização de software.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GenerateSuccessAlert
Indica se deve gerar um alerta para implantação bem-sucedida.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsServicingPlan
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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".
Type: | String[] |
Aliases: | Languages, UpdateLocales, UpdateLocale |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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".
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MicrosoftAsVendor
Indica se a regra inclui apenas atualizações que têm a Microsoft como fornecedor.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifica um nome para a regra de implantação automática para atualizações de software.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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á.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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á.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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)"
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
A partir da versão 2107, quando há vários produtos com o mesmo nome, ele seleciona todos eles.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Aliases: | RunEvaluationAfterRestart |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | RunType |
Accepted values: | DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SeverityType[] |
Aliases: | Severities |
Accepted values: | None, Low, Moderate, Important, Critical |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Aliases: | DelayEnforcementAndUpToGracePeriod |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Superseded
Indica se a regra adiciona atualizações substituídas por outras atualizações.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String[] |
Aliases: | Titles |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String[] |
Aliases: | UpdateClassifications |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateDeploymentWaitDay
Type: | Int32 |
Aliases: | UpdateDeploymentWaitDays |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | UserNotificationType |
Accepted values: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Vendor
Type: | String[] |
Aliases: | Vendors |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VerboseLevel
Especifica o nível de detalhes que você deseja que os clientes reportem para implantações que essa regra cria.
Type: | VerboseLevelType |
Accepted values: | OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
IResultObject
Observações
Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_AutoDeployment classe WMI do servidor.
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