Remediate-Inventory - VMware vSphere Update Manager PowerCLI

Synopsis

Syntax

Related Commands

Scan-Inventory

Detailed Description

Parameters

Name	Description	Required?	Pipeline Input
Server	Specify the vSphere servers on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers.	false	false
Entity	Specify a Template, VirtualMachine, VMHost, Cluster, Datacenter, Folder, or VApp object to remediate.	true	true (ByValue)
Baseline	Specify the baseline you want to use for the remediation.	true	true (ByValue)
ExcludePatch	Specify the patches you want to exclude from the remediation process.	false	true (ByValue)
GuestCreateSnapshot	Indicate that you want to create a snapshot before initializing remediation.	false	false
GuestKeepSnapshotHours	Specify how long (in hours) you want to keep the snapshot. If not set, the snapshots are never deleted.	false	false
GuestTakeMemoryDump	Indicate that you want the guest to take a memory dump while creating a snapshot.	false	false
GuestSnapshotName	Specify a name for the snapshot you want to create before initializing remediation. This parameter is valid only if the GuestCreateSnapshot parameter is set.	false	false
GuestSnapshotDescription	Specify a description for the snapshot you want to create before initializing remediation. This parameter is valid only if the GuestCreateSnapshot parameter is set.	false	false
HostRetryDelaySeconds	Specify how long (in seconds) to wait for the host to enter a maintenance mode.	false	false
HostNumberOfRetries	Specify how many times to retry to set the host into a maintenance mode.	false	false
HostFailureAction	Specify an action in case the host cannot be placed in a maintenance mode. This might happen due to running virtual machines that cannot be automatically migrated to another host. The valid values are FailTask, Retry, PowerOffVMsAndRetry, and SuspendVMsAndRetry.	false	false
HostPreRemediationPowerAction	Specify an action before trying to enter the host into a maintenance mode. The valid values are PowerOffVMs, SuspendVMs, and DoNotChangeVMsPowerState.	false	false
HostDisableMediaDevices	Indicate that you want to temporarily disable any media devices that might prevent the specified hosts from entering maintenance mode.	false	false
HostIgnoreThirdPartyDrivers	Indicate that you want to ignore installed third-party software that is incompatible with the upgrade.	false	false
HostEnablePXEbootHostPatching	Indicate that you want to enable PXE booted ESXi hosts patching.	false	false
ClusterDisableDistributedPowerManagement	Indicate that you want to temporarily disable Distributed Power Management (DPM) for the specified clusters. After the remediation, DPM is automatically re-enabled.	false	false
ClusterDisableHighAvailability	Indicate that you want to temporarily disable High Availability (HA) for the specified clusters. After the remediation, HA is automatically re-enabled.	false	false
ClusterDisableFaultTolerance	Indicate that you want to temporarily disable Fault Tolerance (FT) for the specified clusters. After the remediation, FT is automatically re-enabled.	false	false
ClusterEnableParallelRemediation	Indicate that you want to enable parallel remediation for the specified clusters.	false	false
RunAsync	Indicate that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the -RunAsync parameter run " help About_RunAsync" in the vSphere PowerCLI console.	false	false
WhatIf	Indicate that the cmdlet is run only to display the changes that would be made and actually no objects are modified.	false	false
Confirm	Indicate that the cmdlet asks for confirmation before running.	false	false

Name

Description

Required?

Pipeline Input

Default Value

Server

Specify the vSphere servers on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers.

false

Entity

Specify a Template, VirtualMachine, VMHost, Cluster, Datacenter, Folder, or VApp object to remediate.

true

true (ByValue)

Baseline

Specify the baseline you want to use for the remediation.

true

true (ByValue)

ExcludePatch

Specify the patches you want to exclude from the remediation process.

false

true (ByValue)

GuestCreateSnapshot

Indicate that you want to create a snapshot before initializing remediation.

false

GuestKeepSnapshotHours

Specify how long (in hours) you want to keep the snapshot. If not set, the snapshots are never deleted.

false

GuestTakeMemoryDump

Indicate that you want the guest to take a memory dump while creating a snapshot.

false

GuestSnapshotName

Specify a name for the snapshot you want to create before initializing remediation. This parameter is valid only if the GuestCreateSnapshot parameter is set.

false

GuestSnapshotDescription

Specify a description for the snapshot you want to create before initializing remediation. This parameter is valid only if the GuestCreateSnapshot parameter is set.

false

HostRetryDelaySeconds

Specify how long (in seconds) to wait for the host to enter a maintenance mode.

false

HostNumberOfRetries

Specify how many times to retry to set the host into a maintenance mode.

false

HostFailureAction

Specify an action in case the host cannot be placed in a maintenance mode. This might happen due to running virtual machines that cannot be automatically migrated to another host. The valid values are FailTask, Retry, PowerOffVMsAndRetry, and SuspendVMsAndRetry.

false

HostPreRemediationPowerAction

Specify an action before trying to enter the host into a maintenance mode. The valid values are PowerOffVMs, SuspendVMs, and DoNotChangeVMsPowerState.

false

HostDisableMediaDevices

Indicate that you want to temporarily disable any media devices that might prevent the specified hosts from entering maintenance mode.

false

HostIgnoreThirdPartyDrivers

Indicate that you want to ignore installed third-party software that is incompatible with the upgrade.

false

HostEnablePXEbootHostPatching

Indicate that you want to enable PXE booted ESXi hosts patching.

false

ClusterDisableDistributedPowerManagement

Indicate that you want to temporarily disable Distributed Power Management (DPM) for the specified clusters. After the remediation, DPM is automatically re-enabled.

false

ClusterDisableHighAvailability

Indicate that you want to temporarily disable High Availability (HA) for the specified clusters. After the remediation, HA is automatically re-enabled.

false

ClusterDisableFaultTolerance

Indicate that you want to temporarily disable Fault Tolerance (FT) for the specified clusters. After the remediation, FT is automatically re-enabled.

false

ClusterEnableParallelRemediation

Indicate that you want to enable parallel remediation for the specified clusters.

false

RunAsync

Indicate that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the -RunAsync parameter run " help About_RunAsync" in the vSphere PowerCLI console.

false

WhatIf

Indicate that the cmdlet is run only to display the changes that would be made and actually no objects are modified.

false

Confirm

Indicate that the cmdlet asks for confirmation before running.

false

Return Type

Notes

Examples

-------------- EXAMPLE 1 --------------

Remediate-Inventory -Baseline $baseline -Entity $vmhost -RunAsync -Confirm $false

Remediates a host in asynchronous mode.

-------------- Example 2 --------------

Remediate-Inventory -Baseline $vmHardwareUpgradeBaseline -Entity $vm -GuestCreateSnapshot:$true

Upgrades a virtual machine with the latest virtual hardware. If the upgrade fails, the command creates a snapshot of the target virtual machine.

-------------- Example 3 --------------

Remediate-Inventory -Baseline $baseline -Entity $cluster -ClusterDisableDistributedPowerManagement:$true -ClusterDisableFaultTolerance:$true -ClusterDisableHighAvailability:$true

Remediates a cluster with DPM, HA, and FT that are enabled and need to be disabled during the remediation process.

-------------- Example 4 --------------

Remediate-Inventory -Baseline $baseline -Entity $cluster -ClusterEnableParallelRemediation:$true

Remediates a cluster in parallel mode. All hosts in the cluster are remediated simultaneously and that saves time.

-------------- Example 5 --------------

Remediate-Inventory -Baseline $baseline -Entity $vmhost -HostIgnoreThirdPartyDrivers:$true

Remediates a host with preinstalled third party drivers, which prevent host from upgrade.