Get-IpamAddressSpace
Gets address spaces in IPAM.
Syntax
Get-IpamAddressSpace
[[-Name] <String[]>]
[[-Type] <AddressSpaceType[]>]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[<CommonParameters>]
Get-IpamAddressSpace
-MappingToProviderAddressSpace <String[]>
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[<CommonParameters>]
Description
The Get-IpamAddressSpace cmdlet gets address spaces in IP Address Management (IPAM). You can specify the MappingToProviderAddressSpace parameter to get all customer address spaces that belong to a provider address group. Customer address spaces in IPAM belong to a single provider address space. You can use the Name parameter to get address spaces that match the address space names that you specify. You can use the Type parameter to gets address spaces that match the types of address spaces that you specify. You can use wildcards for the Name parameter. Use wildcards to gets all address spaces that have a specified prefix or suffix. If you do not specify any parameters, the cmdlet gets all address spaces in IPAM.
Examples
Example 1: Get all address spaces
PS C:\> Get-IpamAddressSpace
This command gets all address spaces in IPAM.
Example 2: Get an address space
PS C:\>Get-IpamAddressSpace -Name "ContosoMusic"
Name : ContosoMusic
Type : CustomerAddressSpace
Owner :
Description : Music Mp3
AssociatedProviderAddressSpace : MainDatacenter
Tenant : 4001
VMNetwork : ContosoMusic_Network
IsolationMethod : NVGRE
Ipv4PercentageUtilized : 62.0805369127517
Ipv6PercentageUtilized : 0
CustomConfiguration :
This command gets the address space named ContosoMusic.
Example 3: Retrieve all customer address spaces that map to a provider address space
PS C:\>Get-IpamAddressSpace -MappingToProviderAddressSpace "MainDataCenter"
Name : TreyResearch
Type : CustomerAddressSpace
Owner :
Description : A research and design company
AssociatedProviderAddressSpace : MainDatacenter
Tenant : 1001
VMNetwork : Trey Research_Network
IsolationMethod : NVGRE
Ipv4PercentageUtilized : 15.1515151515152
Ipv6PercentageUtilized : 0
CustomConfiguration :
Name : ContosoMusic
Type : CustomerAddressSpace
Owner :
Description : Music Mp3
AssociatedProviderAddressSpace : MainDatacenter
Tenant : 4001
VMNetwork : ContosoTunes_Network
IsolationMethod : NVGRE
Ipv4PercentageUtilized : 62.0805369127517
Ipv6PercentageUtilized : 0
CustomConfiguration :
This command gets all customer address spaces that belong to the provider address space named MainDataCenter.
Parameters
-AsJob
ps_cimcommon_asjob
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CimSession
Runs the cmdlet in a remote session or on a remote computer. Enter a computer name or a session object, such as the output of a New-CimSessionhttp://go.microsoft.com/fwlink/p/?LinkId=227967 or Get-CimSessionhttp://go.microsoft.com/fwlink/p/?LinkId=227966 cmdlet. The default is the current session on the local computer.
Type: | CimSession[] |
Aliases: | Session |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MappingToProviderAddressSpace
Specifies an array of names of provider address spaces. The cmdlet gets all customer address spaces which belong to the provider address spaces.
Type: | String[] |
Aliases: | PA |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Specifies an array of names of the address spaces. The cmdlet gets all address spaces that match the names that you specify.
Type: | String[] |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ThrottleLimit
Specifies the maximum number of concurrent operations that can be established to run the cmdlet.
If this parameter is omitted or a value of 0
is entered, then Windows PowerShell® calculates an optimum throttle limit for the cmdlet based on the number of CIM cmdlets that are running on the computer.
The throttle limit applies only to the current cmdlet, not to the session or to the computer.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Type
Specifies an array of address space types. The acceptable values for this parameter are:
- ProviderAddressSpace
- CustomerAddressSpace
Type: | AddressSpaceType[] |
Accepted values: | ProviderAddressSpace, CustomerAddressSpace |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Outputs
IpamAddressSpace
Address space information, including the type of address space (CustomerAddressSpace or ProviderAddressSpace).