Update-IpamServer

Update-IpamServer

Updates an IPAM server following an operating system upgrade.

Sintaxis

Parameter Set: UpdateIpamServer0
Update-IpamServer [-AsJob] [-CimSession <CimSession[]> ] [-DeleteSystemCheckFailureRows] [-Force] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Descripción detallada

The Update-IpamServer cmdlet updates an IP Address Management (IPAM) server following an operating system upgrade. IPAM binaries and schema files are made available as a part of an upgrade. An error occurs if there is no update available.

As part of an IPAM server update, this cmdlet performs the following steps:

-- Applies IPAM schema updates. The cmdlet performs data and schema validation of the existing IPAM database, and returns an error if the validation fails. A log is generated on the server in the %SystemDrive%\Windows\System32\IPAM\logs folder. If you specify the DeleteSystemCheckFailureRows parameter, the cmdlet proceeds to automatically delete the error rows.

-- Completes any required data format transformation. This will not result in any loss of existing data.

-- Applies changes in security groups and roles.

No changes are made to any existing user configuration, such as adding users to a security group. Any customizations to IPAM task schedules are retained. In case of an error, any changes will be reverted.

Parámetros

-AsJob

Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-CimSession<CimSession[]>

Ejecuta el cmdlet en una sesión remota o en un equipo remoto. Escriba un nombre de equipo o un objeto de sesión, como la salida de un cmdlet New-CimSession o Get-CimSession. El valor predeterminado es la sesión actual en el equipo local.

Alias

Session

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-DeleteSystemCheckFailureRows

Indicates that the cmdlet automatically deletes errors rows when it validates data and schema for an existing IPAM database. An error occurs if the system check fails.

Alias

DeleteErrorRows

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Force

Fuerza que el comando se ejecute sin pedir confirmación al usuario.

Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-ThrottleLimit<Int32>

Especifica el número máximo de operaciones simultáneas que se pueden establecer para ejecutar el cmdlet. Si se omite este parámetro o es especifica un valor de 0, Windows PowerShell ® calcula un límite óptimo para el cmdlet en función del número de cmdlets de CIM que se estén ejecutando en el equipo. El límite solo se aplica al cmdlet actual, no a la sesión ni al equipo.

Alias

ninguno

¿Requerido?

false

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

falso

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

falso

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los siguientes parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet.

Salidas

El tipo de resultado es el tipo de objetos que emite el cmdlet.

Ejemplos

Example 1: Update an existing IPAM installation

This command updates an existing IPAM installation following an operating system upgrade. If there are system check errors, the cmdlet terminates and generates a log file in the %System Drive%\System 32\IPAM\Logs folder.

PS C:\> Update-IpamServer

Example 2: Update an IPAM installation and delete system check failure rows

This command updates an existing IPAM installation after an operating system upgrade. The command does not terminate due to system check errors, and it deletes conflicting errors in the IPAM database. The command generates a log in the %System Drive%\System 32\IPAM\Logs folder.

PS C:\> Update-IpamServer -DeleteSystemCheckFailureRows