Set-CMAutoDeploymentRuleDeployment
Define uma implementação para uma regra de implementação automática.
Sintaxe
Set-CMAutoDeploymentRuleDeployment
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>]
[-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-InputObject] <IResultObject>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-PassThru]
[-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>]
[-UseUtc <Boolean>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMAutoDeploymentRuleDeployment
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>]
[-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-Id] <Int32>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-PassThru]
[-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>]
[-UseUtc <Boolean>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
O cmdlet Set-CMAutoDeploymentRuleDeployment atualiza uma implementação para uma regra de implementação automática.
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: Definir uma implementação por ID
PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -ID 348 -CollectionName "All Systems" -EnableDeployment $True -SendWakeupPacket $False -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $False -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $False -AllowRestart $False -SuppressRestartServer $False -SuppressRestartWorkstation $False -WriteFilterHandling $False -GenerateSuccessAlert $True -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $False -GenerateOperationsManagerAlert $False -NoInstallOnRemote $False -NoInstallOnUnprotected $False -UseBranchCache $FalseEste comando atualiza as definições da implementação da regra de implementação com o ID de ação 348 e a coleção denominada Todos os Sistemas.
Exemplo 2: Definir uma implementação com uma variável
PS XYZ:\> $ReferenceADR = Get-CMAutoDeploymentRule -Name "TestADR01"
PS XYZ:\> $Deployment = $ReferenceADR | Get-CMAutoDeploymentRuleDeployment
PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -InputObject $Deployment[0] -CollectionName "All Systems" -EnableDeployment $True -SendWakeupPacket $False -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $False -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $False -AllowRestart $False -SuppressRestartServer $False -SuppressRestartWorkstation $False -WriteFilterHandling $False -GenerateSuccessAlert $True -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $False -GenerateOperationsManagerAlert $False -NoInstallOnRemote $False -NoInstallOnUnprotected $False -UseBranchCache $FalseO primeiro comando obtém o objeto de regra de implementação automática com o nome TestADR01 e armazena o objeto na variável $ReferenceADR.
O segundo comando obtém as implementações associadas ao objeto de regra de implementação automática armazenado no $ReferenceADR e armazena as implementações na variável $Deployment.
O último comando atualiza as definições da primeira implementação armazenada no $Deployment.
Parâmetros
-AlertTime
Especifica o número de unidades de tempo para o desvio do prazo.
| Tipo: | Int32 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AlertTimeUnit
Especifica o tipo de unidade de tempo para o desvio do prazo. Os valores válidos são:
- Horas
- Dias
- Semanas
- Meses
| 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 |
-AllowDownloadFromMicrosoftUpdate
Utilize este parâmetro para definir a seguinte opção na página Definições de Transferência das definições de implementação do ADR: se as atualizações de software não estiverem disponíveis no ponto de distribuição nos grupos de limites atuais, vizinhos ou de sites, transfira conteúdos a partir do Microsoft Updates.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AllowRestart
Indica se um reinício do sistema pode ser efetuado fora de quaisquer janelas de manutenção definidas quando o prazo de instalação for atingido.
| 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 instalação de software tem permissão para ser efetuada fora de quaisquer janelas de manutenção definidas quando o prazo de instalação for atingido.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AllowUseMeteredNetwork
Utilize este parâmetro para definir a seguinte opção na página Definições de Transferência das definições de implementação do ADR: permitir que os clientes numa ligação à Internet com tráfego limitado transfiram conteúdo após o prazo de instalação, o que pode incorrer em custos adicionais
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AvailableImmediately
Indica se as atualizações de software estão disponíveis para instalação o mais rapidamente possível após a execução da regra.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AvailableTime
Especifica o número de unidades de tempo para o tempo disponível do software.
| Tipo: | Int32 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-AvailableTimeUnit
Especifica o tipo de unidade de tempo para o tempo disponível do software. Os valores válidos são:
- Horas
- Dias
- Semanas
- Meses
| 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 |
-Collection
Especifica um objeto de coleção de destino para a implementação da atualização de software. Para obter um objeto de coleção, utilize o cmdlet Get-CMCollection .
| Tipo: | IResultObject |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-CollectionId
Especifica o ID da coleção de destino para a implementação da 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 |
-CollectionName
Especifica o nome da coleção de destino para a implementação da 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 |
-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 |
-DeadlineImmediately
Indica se as atualizações de software necessárias são instaladas o mais rapidamente possível quando o prazo for atingido.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DeadlineTime
Especifica o número de unidades de tempo para o prazo.
| Tipo: | Int32 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DeadlineTimeUnit
Especifica o tipo de unidade de hora para o prazo. Os valores válidos são:
- Horas
- Dias
- Semanas
- Meses
| 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 |
-DisableOperationsManager
Indica se os alertas do Operations Manager estão desativados enquanto as atualizações de software são executadas.
| Tipo: | Boolean |
| Aliases: | DisableOperationManager |
| 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 |
-EnableDeployment
Indica se pretende ativar a implementação após a execução desta regra para o grupo de software associado. Se estiver definido como $False, tem de implementar manualmente o grupo de atualizações de software.
| Tipo: | Boolean |
| Aliases: | Enable, EnabledAfterCreate, 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 |
-GenerateOperationsManagerAlert
Indica se os alertas do Operations Manager são gerados quando uma instalação de atualização de software falha.
| Tipo: | Boolean |
| Aliases: | GenerateOperationManagerAlert |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-GenerateSuccessAlert
Indica se um alerta é gerado quando esta regra é executada com êxito.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Id
Especifica o ID de ação da implementação automática da regra de implementação.
| Tipo: | Int32 |
| Aliases: | ActionID |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-InputObject
Especifica um objeto de regra de implementação automática. Para obter um objeto de regra de implementação automática, utilize o cmdlet Get-CMSoftwareUpdateAutoDeploymentRule .
| Tipo: | IResultObject |
| Aliases: | AutoDeploymentRuleDeployment |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-NoInstallOnRemote
Indica se pretende instalar atualizações de software quando as atualizações não estão disponíveis em pontos de distribuição remotos.
| 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 instalar atualizações de software quando as atualizações não estão disponíveis em quaisquer pontos de distribuição desprotegidos.
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-PassThru
Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.
| Tipo: | SwitchParameter |
| 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 |
-SendWakeupPacket
Indica se deve utilizar o Wake-on-LAN para reativar os clientes para as implementações necessárias.
| Tipo: | Boolean |
| Aliases: | EnableWakeOnLan |
| 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 a percentagem, como um número inteiro, da conformidade do cliente. Quando a conformidade do cliente é inferior a esta percentagem, é gerado um alerta.
| Tipo: | Int32 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-SuppressRestartServer
Indica se um reinício do sistema é suprimido nos servidores quando uma atualização de software requer 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 um reinício do sistema é suprimido nas estações de trabalho quando uma atualização de software requer 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 |
-UseBranchCache
Indica se os clientes têm permissão para partilhar conteúdos com outros clientes 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 comportamento de notificação da experiência visual do utilizador. Os valores válidos são:
- DisplayAll
- DisplaySoftwareCenterOnly
- OcultarTodos
| Tipo: | UserNotificationOption |
| 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 a agenda para esta implementação é avaliada com base na Hora Coordenada Universal (UTC).
| Tipo: | Boolean |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-VerboseLevel
Especifica a quantidade de detalhes de estado que os clientes comunicam relativamente às implementações criadas por esta regra. Os valores válidos são:
- OnlyErrorMessages
- OnlySuccessAndErrorMessages
- AllMessages
| 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 as alterações são consolidadas dentro do prazo ou durante uma janela de manutenção (requer reinícios). Se definido como $False, o conteúdo é aplicado na sobreposição e consolidado 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