Set-CMSoftwareUpdateAutoDeploymentRule
SYNOPSIS
Modifique uma regra de implementação automática (ADR) para atualizações de software.
SYNTAX
SearchByNameMandatory (Padrão)
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>]
SearchByIdMandatory
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>]
SearchByValueMandatory
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 CmSoftwareUpdateAutoDeploymentRule cmdlet modifica uma regra de implantação automática (ADR) para atualizações de software. Para obter uma regra existente, utilize o cmdlet Get-CMSoftwareUpdateAutoDeploymentRule.
O Gestor de Configuração utiliza regras para gerir a implementação automática de atualizações de software. Quando uma regra é executado, o Gestor de Configuração adiciona atualizações que se qualificam para a regra a um grupo de atualização de software. O servidor 'Gestor de Configuração' descarrega ficheiros de conteúdo e copia-os para pontos de distribuição e, em seguida, atualiza os computadores dos clientes.
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\>
. Para mais informações, consulte a partida.
EXAMPLES
Exemplo 1: Modificar a seleção de idiomas e o nome de uma regra
Este comando modifica a regra de implantação automática denominada DeploymentRule07. Especifica português (Brasil) para os ficheiros de atualização de software Windows que o site descarrega. 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 que se seguem demonstram diferentes métodos 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 um ADR para vários idiomas
Este exemplo altera o ADR para utilizar os critérios linguísticos para três línguas: inglês, húngaro e chinês (Simplificado, RPC). Também altera estes idiomas para o Windows e Office 365 atualizar binários para descarregar.
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)"
PARAMETERS
-AddToExistingSoftwareUpdateGroup
Indica se a regra adiciona a um grupo de atualização existente. Se este valor for $True
, cada vez que a regra executa e encontra novas atualizações, adiciona-as a um grupo de atualização existente. Se este valor $False
for, cria um novo grupo de atualização. Especifique o grupo de atualização existente ou atribua um nome para o novo grupo de atualização utilizando o parâmetro DeploymentPackageName.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Hora do Alerta
Especifica um número inteiro compensado 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 utilizando o parâmetro -AlertTimeUnit.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AlertaTimeunit
Especifica uma unidade de tempo para o parâmetro -AlertTime.
Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowRestart
Indica se permite que um computador reinicie se a 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 de computadores.
- Se este valor
$True
for, o Gestor de Configuração reinicia o computador, se necessário, para completar a atualização. - Se este valor
$False
for, o Gestor de Configuração não reinicia o computador.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Permitir instalação DesoftwareInstallOutsideMaintenanceWindow
Indica se a implementação da atualização ocorre mesmo que seja programada 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 de computadores.
- Se este valor for
$True
, o Gestor de Configuração implementa a atualização mesmo que a hora programada caia fora da janela de serviço. - Se este valor
$False
for, o Gestor de Configuração não implementa a atualização fora da janela de serviço. Espera até poder implantar numa janela de serviço.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Permitir a Rede De Mecânica de Uso
Indica se permite que os clientes descarreguem conteúdo sobre uma ligação à Internet medido após o prazo, o que pode incorrer em despesas adicionais.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Arquitetura
A partir da versão 1906, utilize este parâmetro para definir o filtro de propriedade Architecture na página de Atualizações de Software das propriedades ADR.
Type: ArchitectureType[]
Parameter Sets: (All)
Aliases: Architectures
Accepted values: Arm64, Itanium, X64, X86
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Artigos
Especifica um conjunto de critérios, como cordas, para atualizações de software. A regra adiciona atualizações de software que têm IDs de artigo que cumprem critérios especificados para o grupo de atualização de software.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisponívelImmediadamente
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 -Tempo Disponível e -AvailableTimeUnit para especificar quanto tempo a regra é executado para implementar as atualizações.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Tempo disponível
Especifica um período de tempo como um inteiro. O Gestor de Configuração implementa as atualizações muito tempo depois de a regra ser executado. Especifique uma unidade de tempo utilizando o parâmetro -AvailableTimeUnit.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisponívelTimeunit
Especifica uma unidade de tempo para o parâmetro Tempo Disponível.
Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-BoletimId
Especifica um conjunto de critérios, como cordas, para atualizações de software. A regra adiciona atualizações de software que têm IDs de boletim que cumprem critérios especificados para o grupo de atualização de software.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CMTag
Esta propriedade está reservada para uso futuro.
Type: CMTagTypes[]
Parameter Sets: (All)
Aliases:
Accepted values: None, UUP
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome de coleção
Especifique um nome de recolha como o alvo para a regra de implantação automática.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-ContentAmento
Utilize este parâmetro para definir o filtro de propriedade Content Size (KB) na página de Atualizações de Software das propriedades ADR.
Type: String[]
Parameter Sets: (All)
Aliases: ContentSizes
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PersonalSeverity
Especifica uma série de tipos de severidade personalizados para atualizações de software. A regra adiciona atualizações de software que têm níveis de gravidade personalizados que cumprem critérios especificados para o grupo de atualização de software.
Type: SeverityType[]
Parameter Sets: (All)
Aliases:
Accepted values: None, Low, Moderate, Important, Critical
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DataReleasedOrRevised
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 satisfaz os critérios especificados para o grupo de atualização de software.
Type: DateReleasedOrRevisedType
Parameter Sets: (All)
Aliases:
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
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeadlineImmediatemente
Indica se deve impor o prazo assim que a regra se esgota. Se especificar um valor de $False
, use os parâmetros -DeadlineTime e -DeadlineTimeUnit para especificar quanto tempo a regra termina para fixar o prazo. Após o prazo, o Gestor de Configuração instala as atualizações necessárias.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeadlineTime
Especifica um período de tempo como um inteiro. O prazo para atualizações é tão longo quanto depois de a regra ser terminada. Especifique uma unidade de tempo utilizando o parâmetro DeadlineTimeUnit.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeadlineTimeUnit
Especifica uma unidade de tempo para o parâmetro -DeadlineTime.
Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ImplementarWithoutLicense
Indica se a regra implementa atualizações sem licenças.
- Se especificar um valor de , O Gestor de
$True
Configuração implementa todas as atualizações para esta regra e aprova quaisquer contratos de licença. - Se este valor for
$False
, o Gestor de Configuração implementa apenas atualizações que não incluem uma licença ou para as quais o contrato de licença foi aprovado.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeploymentPackage
Utilize este parâmetro para definir o pacote de implementação para a regra de implantação automática de atualização de software existente. Para não requerer uma embalagem, desa um valor para $null
.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeploymentPackageName
Utilize este parâmetro para definir o pacote de implementação para a regra de implantação automática de atualização de software existente. Para não requerer uma embalagem, desa um valor para $null
.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Implantação
Type: DeploymentRing
Parameter Sets: (All)
Aliases:
Accepted values: CB, Release, BusinessMainstream, Cbb, Ltsb
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Descrição
Especifica uma descrição para a regra de implementação automática para atualizações de software.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableOperaçãoManager
Indica se desativar System Center alertas do Gestor de Operações durante as atualizações do software.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DownloadFromInternet
Indica se os computadores descarregam atualizações de software a partir da internet. Se especificar um valor de $False
, especifique uma localização alternativa onde os computadores podem descarregar atualizações utilizando o parâmetro -Localização.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DownloadFromMicrosoftUpdate
Indica se os computadores descarregam conteúdo do Microsoft Update se esse conteúdo não estiver disponível num ponto de distribuição preferido do ponto de distribuição remoto.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Ativar
Especificar se a regra de implantação automática está ativada após a sua criação.
Type: Boolean
Parameter Sets: (All)
Aliases: Enabled, EnableDeployment
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnabledAfterCreate
Indica se deve ativar a implementação do software para o grupo de atualização de software associado após a execução desta regra. Se este valor $False
for, desloque manualmente o grupo de atualização de software.
Type: Boolean
Parameter Sets: (All)
Aliases: EnableAfterCreate
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Force
Executar o comando sem pedir confirmação.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-GenerateFailureAlert
Se a regra falhar, crie um alerta de Gestor de Configuração.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Gerar OperationManagerAlert
Indica se gera alertas do Gestor de Operações durante uma atualização de software.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-GenerateSuccessAlert
Indica se deve gerar um alerta para uma implementação bem sucedida.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- ID
Especifique um conjunto de IDs de regra de implantação automática para configurar. Este valor é propriedade autoDeploymentID do objeto ADR.
Type: String[]
Parameter Sets: SearchByIdMandatory
Aliases: AutoDeploymentId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Especifique um objeto de regra de implantação automática. Para obter um objeto ADR, utilize o cmdlet Get-CMSoftwareUpdateAutoDeploymentRule.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Língua
Especifique um conjunto 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 para o grupo de atualização de software.
Utilize o formato do idioma como mostrado na consola. Por exemplo:
English
Hungarian
Chinese (Simplified, PRC)
O formato para a matriz de cordas é: "English","Hungarian","Chinese (Simplified, PRC)"
Dica
Se executar este cmdlet num computador onde Windows tem uma UI localizada, os nomes linguísticos podem ser diferentes. Por exemplo, a versão inglesa de Windows usa "dinamarquês", mas a versão dinamarquesa de Windows usa "Dansk".
Este parâmetro substitui quaisquer valores existentes com os valores que especifica.
Type: String[]
Parameter Sets: (All)
Aliases: Languages, UpdateLocales, UpdateLocale
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Eleição linguística
Especifique um conjunto de linguagens. Os clientes descarregam atualizações de software disponíveis nos idiomas especificados e atualizações neutras em termos de idioma.
Utilize o formato do idioma como mostrado na consola. Por exemplo:
English
Hungarian
Chinese (Simplified, PRC)
O formato para a matriz de cordas é: "English","Hungarian","Chinese (Simplified, PRC)"
Dica
Se executar este cmdlet num computador onde Windows tem uma UI localizada, os nomes linguísticos podem ser diferentes. Por exemplo, a versão inglesa de Windows usa "dinamarquês", mas a versão dinamarquesa de Windows usa "Dansk".
Este parâmetro substitui quaisquer valores existentes com os valores que especifica.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Localização
Especifica uma localização na sua rede onde os computadores podem descarregar atualizações de software. Para utilizar esta localização, especifique um valor do $False
parâmetro -DownloadFromInternet.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
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
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Especifica um nome para a regra de implementação automática para atualizações de software.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Novo Nome
Especifique um novo nome para o ADR.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NoInstallOnRemote
Indica se deve não permitir a instalação de atualizações em sistemas remotos.
- Se especificar um valor de , se o cliente estiver dentro de
$True
um limite de rede lento ou não confiável, ou quando o cliente usa uma localização de origem de retorno para o conteúdo, então o Gestor de Configuração não instala atualizações de software. - Se especificar um valor
$False
de, o produto da instalação.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NoInstallOnInpretes
Indica se deve não permitir a instalação de atualizações em sistemas desprotegidos.
- Se especificar um valor de , se as atualizações de
$True
software não estiverem disponíveis em quaisquer pontos de distribuição preferidos, o Gestor de Configuração não descarrega e instala atualizações de software. - Se especificar um valor
$False
de, o produto da instalação.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-O365Elhagem
Aplica-se à versão 1906 e mais tarde. Utilize este parâmetro para definir a Office 365 seleção de idiomas de Atualização do Cliente. Especifique um conjunto de linguagens. Os clientes descarregam atualizações de software disponíveis nos idiomas especificados e atualizações neutras em termos de idioma.
Utilize o formato do idioma apresentado na consola para a seleção de idiomas Windows Atualização. Este formato é o mesmo que o parâmetro LanguageSelection. Por exemplo:
English
Hungarian
Chinese (Simplified, PRC)
O formato para a matriz de cordas é: "English","Hungarian","Chinese (Simplified, PRC)"
Dica
Se executar este cmdlet num computador onde Windows tem uma UI localizada, os nomes linguísticos podem ser diferentes. Por exemplo, a versão inglesa de Windows usa "dinamarquês", mas a versão dinamarquesa de Windows usa "Dansk".
Atualmente não é possível especificar com este parâmetro todos os idiomas disponíveis na consola Do Gestor de Configuração. Por exemplo, não é possível 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. Esta alteração alinha este parâmetro com as opções na consola 'Gestor de Configuração'. Por exemplo, -O365LanguageSelection "English (United States)"
Este parâmetro substitui quaisquer valores existentes com os valores que especifica.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- PassThru
Devolve um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Produto
Especifica um conjunto de critérios, como cordas, para atualizações de software. A regra adiciona atualizações de software para produtos que satisfaçam critérios especificados ao grupo de atualização de software.
Type: String[]
Parameter Sets: (All)
Aliases: Products
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RequirePostRebootFullScan
A partir da versão 1906, utilize este parâmetro para definir a seguinte opção na página Experiência do Utilizador das definições de implementação ADR: Se qualquer atualização nesta implementação exigir um reinício do sistema, executar atualizações do ciclo de avaliação da implementação após o reinício.
Type: Boolean
Parameter Sets: (All)
Aliases: RunEvaluationAfterRestart
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Exigido
Especifica um conjunto de critérios, como cordas, para atualizações de software. A regra adiciona atualizações de software identificadas por necessidade que satisfaçam critérios especificados para o grupo de atualização de software.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RunType
Especifique o horário recorrente para quando o site avaliar o ADR.
Se especificar RunTheRuleOnSchedule
, especifique um horário utilizando o parâmetro -Agendar.
Type: RunType
Parameter Sets: (All)
Aliases:
Accepted values: DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Horário
Especifica um objeto de agenda para a implantação. Para obter um objeto de agenda, utilize o cmdlet New-CMSchedule. Especifique um calendário para este parâmetro se especificar um valor para RunTheRuleOnSchedule
o parâmetro -RunType.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SendWakeupPacket
Indica se deve enviar um pacote de despertar para os computadores antes do início da implantação.
- Se este valor
$True
for, o Gestor de Configuração acorda um computador do sono. - Se este valor
$False
for, não desperta os computadores do sono.
Para que os computadores acordem, primeiro tem de configurar Wake On LAN.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Severidade
Especifica uma série 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.
Type: SeverityType[]
Parameter Sets: (All)
Aliases: Severities
Accepted values: None, Low, Moderate, Important, Critical
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SoftDeadlineEnabled
A partir da versão 1906, utilize este parâmetro para definir a seguinte opção na página de Agenda de Implementação das definições de implementação ADR: Adiar a execução desta implementação de acordo com as preferências do utilizador, até ao período de carência definido nas definições do cliente.
Type: Boolean
Parameter Sets: (All)
Aliases: DelayEnforcementAndUpToGracePeriod
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SucessoPercentage
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 Gestor de Configuração produz alertas opcionais.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Substituído
Indica se a regra adiciona atualizações superadas por outras atualizações.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SupressorrartServer
Indica se deve 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.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SupressorartWorkstation
Indica se deve 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.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Título
Especifica um conjunto de critérios, como cordas, para atualizações de software. A regra adiciona atualizações de software que têm títulos que cumprem critérios especificados para o grupo de atualização de software.
Type: String[]
Parameter Sets: (All)
Aliases: Titles
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ActualizaçãoClassificação
Especifica um conjunto de critérios, como cordas, 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 para o grupo de atualização de software.
Type: String[]
Parameter Sets: (All)
Aliases: UpdateClassifications
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UpdateDeploymentWaitDay
Type: Int32
Parameter Sets: (All)
Aliases: UpdateDeploymentWaitDays
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AtualizaçãoDescrição
Especifica um conjunto de critérios, como cordas, 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 para o grupo de atualização de software.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseBranchCache
Indica se deve utilizar Windows BranchCache para esta implementação de atualização. Se especificar um valor $True
de, os clientes partilham conteúdo na mesma sub-rede.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseUtc
Indica se deve utilizar o Tempo Universal Coordenado (UTC).
- Se este valor
$True
for, o Gestor de Configuração utiliza o UTC para esta implementação. - Se este valor
$False
for, o Gestor de Configuração utiliza a hora local.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Notificação do Utilizador
Especifica o tipo de notificação do utilizador.
DisplayAll
: Exibir no Centro de Software e mostrar todas as notificações.DisplaySoftwareCenterOnly
: Display in Software Center e apenas mostrar notificações de reiniciar o computador.HideAll
: Ocultar-se no Centro de Software e todas as notificações.
Type: UserNotificationType
Parameter Sets: (All)
Aliases:
Accepted values: DisplayAll, DisplaySoftwareCenterOnly, HideAll
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Fornecedor
Type: String[]
Parameter Sets: (All)
Aliases: Vendors
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-VerboseLevel
Especifica o nível de detalhe que pretende que os clientes reportem para implementações que esta regra cria.
Type: VerboseLevelType
Parameter Sets: (All)
Aliases:
Accepted values: OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- O QueIf
Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-WriteFilterHandling
Indica se deve ativar filtros de escrita para dispositivos incorporados.
- Por um valor de
$True
, o dispositivo comete alterações durante uma janela de manutenção. Esta ação requer um recomeço. - Por um valor de
$False
, o dispositivo guarda alterações numa sobreposição e compromete-as mais tarde.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
Sistema.Objeto
NOTAS
RELATED LINKS
Desativação CMSoftwareUpdateAutoDeploymentRule
Enable-CMSoftwareUpdateAutoDeploymentRule
Get-CMSoftwareUpdateAutoDeploymentRule
Invocar-CMSoftwareUpdateAutoDeploymentRule