Add-IpamAddressSpace

Add-IpamAddressSpace

Adds an address space to IPAM.

Syntax

Parameter Set: ProviderAddressSpace
Add-IpamAddressSpace -Name <String> -ProviderAddressSpace [-AsJob] [-CimSession <CimSession[]> ] [-CustomConfiguration <String> ] [-Description <String> ] [-Owner <String> ] [-PassThru] [-ThrottleLimit <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: CustomerAddressSpace
Add-IpamAddressSpace -AssociatedProviderAddressSpace <String> -CustomerAddressSpace -IsolationMethod <String> -Name <String> [-AsJob] [-CimSession <CimSession[]> ] [-CustomConfiguration <String> ] [-Description <String> ] [-Force] [-Owner <String> ] [-PassThru] [-Tenant <String> ] [-ThrottleLimit <Int32> ] [-VmNetwork <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detaillierte Beschreibung

The Add-IpamAddressSpace cmdlet adds an address space to IP Address Management (IPAM). A set of connected networks forms an address space. In IPAM, all IP blocks, IP subnets, IP ranges, and IP addresses in a set of connected networks are grouped in an address space container. To support network virtualization, IPAM provides two types of address spaces: provider and customer. By default, all IPAM entities reside in the built-in address space called Default. Non-virtualized network entities, such as a subnet or an IP address range, reside in the Default address space.

Parameter

-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[]>

Führt das Cmdlet in einer Remotesitzung oder auf einem Remotecomputer aus. Geben Sie einen Computernamen oder ein Sitzungsobjekt ein, z. B. die Ausgabe eines Cmdlets New-CimSession oder Get-CimSession. Der Standardwert ist die aktuelle Sitzung auf dem lokalen Computer.

-CustomConfiguration<String>

Specifies semicolon-separated name/value pairs. This parameter specifies custom metadata that is associated with the address space.

-CustomerAddressSpace

Indicates that the type of address space that you add is a customer address space.

-Description<String>

Specifies a description of the address space.

-Force

Erzwingt, dass der Befehl ohne Benutzerbestätigung ausgeführt wird.

-IsolationMethod<String>

Specifies the network virtualization mechanism for the address space. Die folgenden Werte für diesen Parameter sind zulässig:

-- NVGRE
-- IPRewrite

-Name<String>

Specifies a name for the address space.

-Owner<String>

Specifies the owner of the address space.

-PassThru

Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

-ProviderAddressSpace

Indicates that the type of address space that you add is a provider address space.

-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 compatible with the virtual machine network that you specify for the VmNetwork parameter.

-ThrottleLimit<Int32>

Gibt die maximale Anzahl von gleichzeitigen Vorgängen an, die zum Ausführen dieses Cmdlets eingerichtet werden können. Wenn dieser Parameter ausgelassen oder der Wert 0 eingegeben wird, berechnet Windows PowerShell® einen optimalen Drosselungsgrenzwert für das Cmdlet basierend auf der Anzahl der CIM-Cmdlets, die auf dem Computer ausgeführt werden. Die Drosselungsgrenze gilt nur für das aktuelle Cmdlet und nicht für die Sitzung oder den Computer.

-VmNetwork<String>

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

-Confirm

Sie werden vor dem Ausführen des Cmdlets zur Bestätigung aufgefordert.

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

• IpamAddressSpace

  Object that represents an address space in IPAM.

Beispiele

Example 1: Add a provider address space

This command adds a provider address space named ProviderAddSpace01 to IPAM.

PS C:\> Add-IpamAddressSpace -Name "ProviderAddSpace01" -ProviderAddressSpace -Description "Provider address space for Contoso"

Example 2: Add a customer address space

This command adds a customer address space named CustomerAddSpace01 to IPAM. The command specifies that the provider address space named ProviderAddSpace01 is associated with the customer address space. The command specifies the Network Virtualization using Generic Routing Encapsulation (NVGRE) network virtualization mechanism for the address space.

PS C:\> Add-IpamAddressSpace -Name "CustomerAddSpace01" -CustomerAddressSpace -AssociatedProviderAddressSpace "ProviderAddSpace01" -IsolationMethod NVGRE -PassThru

Verwandte Themen

Get-IpamAddressSpace

Set-IpamAddressSpace

Remove-IpamAddressSpace