Freigeben über


New-AzsIPPool

Create an IP pool. Once created an IP pool cannot be deleted.

Syntax

New-AzsIPPool
   -Name <String>
   [-Location <String>]
   [-ResourceGroupName <String>]
   [-SubscriptionId <String>]
   [-AddressPrefix <String>]
   [-EndIPAddress <String>]
   [-NumberOfAllocatedIPAddress <Int64>]
   [-NumberOfIPAddress <Int64>]
   [-NumberOfIPAddressesInTransition <Int64>]
   [-StartIPAddress <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]
New-AzsIPPool
   -Name <String>
   -Pool \<IIPPool>
   [-Location <String>]
   [-ResourceGroupName <String>]
   [-SubscriptionId <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

Description

Create an IP pool. Once created an IP pool cannot be deleted.

Examples

Example 1:

PS C:\> New-AzsIpPool -Name IpPool4 -StartIpAddress ***.***.***.*** -EndIpAddress ***.***.***.*** -AddressPrefix ***.***.***.***/24

Create a new IP pool.

Parameters

-AddressPrefix

The address prefix.

Type:System.String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AsJob

Run the command as a job

Type:System.Management.Automation.SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:System.Management.Automation.SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with Azure.

Type:System.Management.Automation.PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EndIPAddress

The ending IP address.

Type:System.String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

The region where the resource is located.

Type:System.String
Position:Named
Default value:(Get-AzLocation)[0].Location
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

IP pool name.

Type:System.String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoWait

Run the command asynchronously

Type:System.Management.Automation.SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NumberOfAllocatedIPAddress

The number of currently allocated IP addresses.

Type:System.Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NumberOfIPAddress

The total number of IP addresses.

Type:System.Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NumberOfIPAddressesInTransition

The current number of IP addresses in transition.

Type:System.Int64
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Pool

This resource defines the range of IP addresses from which addresses are allocated for nodes within a subnet. To construct, see NOTES section for POOL properties and create a hash table.

Type:Microsoft.Azure.PowerShell.Cmdlets.FabricAdmin.Models.Api20160501.IIPPool
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Name of the resource group.

Type:System.String
Position:Named
Default value:-join("System.",(Get-AzLocation)[0].Location)
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StartIPAddress

The starting IP address.

Type:System.String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Subscription credentials that uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call.

Type:System.String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

List of key-value pairs.

Type:System.Collections.Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:System.Management.Automation.SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.Azure.PowerShell.Cmdlets.FabricAdmin.Models.Api20160501.IIPPool

Outputs

Microsoft.Azure.PowerShell.Cmdlets.FabricAdmin.Models.Api20160501.IIPPool

Notes

COMPLEX PARAMETER PROPERTIES To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.

POOL <IIPPool>: This resource defines the range of IP addresses from which addresses are allocated for nodes within a subnet.

  • [Location <String>]: The region where the resource is located.
  • [Tag \<IResourceTags>]: List of key-value pairs.
    • [(Any) <String>]: This indicates any property can be added to this object.
  • [AddressPrefix <String>]: The address prefix.
  • [EndIPAddress <String>]: The ending IP address.
  • [NumberOfAllocatedIPAddresses <Int64?>]: The number of currently allocated IP addresses.
  • [NumberOfIPAddresses <Int64?>]: The total number of IP addresses.
  • [NumberOfIPAddressesInTransition <Int64?>]: The current number of IP addresses in transition.
  • [StartIPAddress <String>]: The starting IP address.