Set-IpamAddressSpace

Set-IpamAddressSpace

Modifies address spaces in IPAM.

Sintaxis

Parameter Set: ByName
Set-IpamAddressSpace [-Name] <String[]> [-AddCustomConfiguration <String> ] [-AsJob] [-AssociatedProviderAddressSpace <String> ] [-CimSession <CimSession[]> ] [-Description <String> ] [-IsolationMethod <String> ] [-NewName <String> ] [-Owner <String> ] [-PassThru] [-RemoveCustomConfiguration <String> ] [-Tenant <String> ] [-ThrottleLimit <Int32> ] [-VmNetwork <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: InputObject (cdxml)
Set-IpamAddressSpace -InputObject <CimInstance[]> [-AddCustomConfiguration <String> ] [-AsJob] [-AssociatedProviderAddressSpace <String> ] [-CimSession <CimSession[]> ] [-Description <String> ] [-IsolationMethod <String> ] [-NewName <String> ] [-Owner <String> ] [-PassThru] [-RemoveCustomConfiguration <String> ] [-Tenant <String> ] [-ThrottleLimit <Int32> ] [-VmNetwork <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Descripción detallada

The Set-IpamAddressSpace cmdlet modifies address spaces in IP Address Management (IPAM). Specify the address spaces to modify, or use the InputObject parameter to specify an IpamAddressSpace object to modify. You must specify at least one optional parameter in addition to the Name parameter or InputObject parameter.

Parámetros

-AddCustomConfiguration<String>

Specifies semi-colon separated name/value pairs. This parameter specifies custom metadata that are associated with the address space.

-AsJob

-AssociatedProviderAddressSpace<String>

Specifies the provider address space that is associated with the customer address space. Customer address spaces in IPAM belong to a single provider address space.

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

-Description<String>

Specifies a description of the address space.

-InputObject<CimInstance[]>

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

-IsolationMethod<String>

Specifies the network virtualization mechanism for the address space. Los valores aceptables para este parámetro son los siguientes:

-- NVGRE
-- IPRewrite

-Name<String[]>

Specifies an array of names of the address spaces. The cmdlet modifies the address spaces.

-NewName<String>

Specifies a new name for the address space.

-Owner<String>

Specifies the owner of the address space.

-PassThru

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

-RemoveCustomConfiguration<String>

Specifies a semi-colon separated string of custom field names. The cmdlet removes the custom field names from the address spaces.

-Tenant<String>

Specifies the tenant ID, as a string, that is associated with the customer address space. You must specify a tenant ID that is associated with the virtual machine network that you specify for the VmNetwork parameter.

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

-VmNetwork<String>

Specifies the name of the virtual machine network for the customer address space. You must specify a virtual network that is associated with the tenant that you specify for the Tenant parameter.

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

• IpamAddressSpace

  An object that represents an address space in IPAM.

Ejemplos

Example 1: Rename an address space

This command renames the address space named OneDataCenter to MainDataCenter.

PS C:\> Set-IpamAddressSpace -Name "OneDataCenter" -NewName "MainDataCenter" -PassThru

Example 2: Change the provider address space for a customer address space

This command changes the provider address space that is associated with a customer address space. The command uses the Get-IpamAddressSpace cmdlet to get an IpamAddressSpace object that contains the customer address space named WoodgroveAddSpace. The command passes the object to the Set-IpamAddressSpace cmdlet by using the pipeline operator. The command sets the provider address space named MainDataCenter for the customer address space stored in the IpamAddressSpace object.

PS C:\> Get-IpamAddressSpace -Name "WoodgroveAddSpace" | Set-IpamAddressSpace -AssociatedProviderAddressSpace "MainDataCenter" -PassThru

Temas relacionados

Get-IpamAddressSpace

Add-IpamAddressSpace

Remove-IpamAddressSpace