Remove-IpamBlock

Remove-IpamBlock

Removes an address block from IPAM.

Sintaxis

Parameter Set: ByKeySet
Remove-IpamBlock [-NetworkId] <String[]> [-StartIPAddress] <IPAddress[]> [-EndIPAddress] <IPAddress[]> [-AsJob] [-CimSession <CimSession[]> ] [-DeleteAssociatedSubBlocks] [-Force] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: InputObject (cdxml)
Remove-IpamBlock -InputObject <CimInstance[]> [-AsJob] [-CimSession <CimSession[]> ] [-DeleteAssociatedSubBlocks] [-Force] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Descripción detallada

The Remove-IpamBlock cmdlet removes an IP address block from IP Address Management (IPAM). Specify an address block by using the StartIPAddress and EndIPAddress parameters, or use the InputObject parameter to specify the input to this cmdlet. You can specify the DeleteAssociatedSubBlocks parameter to remove all the child IP address ranges mapped to the address block. When you remove an address block, IPAM remaps all subnets and unmaps some subnets which it previously mapped to an address block.

Parámetros

-AsJob

-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.

-DeleteAssociatedSubBlocks

Indicates that the cmdlet removes the child IP address ranges that belong to the address block.

-EndIPAddress<IPAddress[]>

Specifies an array of end addresses for IP address blocks.

-Force

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

-InputObject<CimInstance[]>

Especifica la entrada para este cmdlet. Puede usar este parámetro o puede canalizar la entrada a este cmdlet.

-NetworkId<String[]>

Specifies the IP network prefix, in Classless Interdomain Routing (CIDR) notation, for the network blocks to be deleted.

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ningún resultado.

-StartIPAddress<IPAddress[]>

Specifies an array of start addresses for IP address blocks.

-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.

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.

-WhatIf

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

<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.

• IpamBlock

  Represents an address block in IPAM.

Ejemplos

Example 1: Remove an IP address block

This command removes the IP address block from the network that has the ID 10.15.0.0/8/16. The command specifies the start and end addresses for the address block.

PS C:\> Get-IpamBlock -NetworkId "10.15.0.0/16" -StartIPAddress 10.15.0.0 -EndIPAddress 10.15.255.255 | Remove-IpamBlock

Example 2: Remove all child IP address ranges that belong to an address block

This command removes all child IP address ranges that belong to the address block from the network that has the ID 10.0.0.0/8. The command specifies the start and end addresses for the address block.

PS C:\> Get-IpamBlock -NetworkId "10.0.0.0/8" -StartIPAddress 10.0.0.0 -EndIPAddress 10.255.255.255 | Remove-IpamBlock -DeleteAssociatedSubBlocks

Temas relacionados

Get-IpamBlock

Set-IpamBlock

Add-IpamBlock