New-AzInterconnectBlock

Module:

Az.Compute Module

Creates an Interconnect Block resource.

Syntax

Default (Default)

New-AzInterconnectBlock
    -ResourceGroupName <String>
    -Name <String>
    -Location <String>
    -InterconnectGroupId <String>
    -SkuName <String>
    -SkuCapacity <Int64>
    [-Zone <String[]>]
    [-SkuTier <String>]
    [-ExcludeZone <String[]>]
    [-IncludeZone <String[]>]
    [-ZonePlacementPolicy <String>]
    [-Tag <Hashtable>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The New-AzInterconnectBlock cmdlet creates a Microsoft.Compute/interconnectBlocks resource, which pre-allocates a specified number of VMs within a network boundary tied to an InterconnectGroup.

Examples

Example 1: Create an Interconnect Block

$igId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Network/interconnectGroups/myIG"
New-AzInterconnectBlock -ResourceGroupName "myRG" -Name "myICB" -Location "eastus" -InterconnectGroupId $igId `
    -SkuName "Standard_ND128isr_GB300_v6" -SkuCapacity 18 -Zone @("1")

This command creates an Interconnect Block with a capacity of 18 VM instances in availability zone 1.

Example 2: Create an Interconnect Block with placement constraints and tags

$igId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.Network/interconnectGroups/myIG"
New-AzInterconnectBlock -ResourceGroupName "myRG" -Name "myICB" -Location "eastus" -InterconnectGroupId $igId `
    -SkuName "Standard_ND128isr_GB300_v6" -SkuCapacity 36 -Zone @("1") `
    -ZonePlacementPolicy "Any" -IncludeZone @("1","2") `
    -Tag @{ Environment = "Production"; Workload = "AI-Training" }

This command creates an Interconnect Block with placement constraints and tags.

Parameters

-AsJob

Run cmdlet in the background

Parameter properties

Type:	SwitchParameter
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:	SwitchParameter
Default value:	None
Supports wildcards:	False
DontShow:	False
Aliases:	cf

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-DefaultProfile

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

Parameter properties

Type:	IAzureContextContainer
Default value:	None
Supports wildcards:	False
DontShow:	False
Aliases:	AzContext, AzureRmContext, AzureCredential

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-ExcludeZone

List of availability zones to exclude from placement consideration.

Parameter properties

Type:	String[]
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	True
Value from remaining arguments:	False

-IncludeZone

List of availability zones to include for placement consideration.

Parameter properties

Type:	String[]
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	True
Value from remaining arguments:	False

-InterconnectGroupId

The ARM resource ID of the Microsoft.Network/interconnectGroups resource. Required at create and immutable thereafter.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	True
Value from remaining arguments:	False

-Location

Specifies the location for the Interconnect Block. Immutable after create.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	True
Value from remaining arguments:	False

-Name

Specifies the name of the Interconnect Block resource.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	True
Value from remaining arguments:	False

-ResourceGroupName

Specifies the name of a resource group.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	True
Value from remaining arguments:	False

-SkuCapacity

The number of VM instances to reserve. Must be a multiple of 18.

Parameter properties

Type:	Int64
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	True
Value from remaining arguments:	False

-SkuName

The VM SKU name for the Interconnect Block (e.g. Standard_ND128isr_GB300_v6). Immutable after create.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	True
Value from remaining arguments:	False

-SkuTier

The SKU tier.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	True
Value from remaining arguments:	False

-Tag

Specifies that resources and resource groups can be tagged with a set of name-value pairs.

Parameter properties

Type:	Hashtable
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	True
Value from remaining arguments:	False

-WhatIf

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

Parameter properties

Type:	SwitchParameter
Default value:	None
Supports wildcards:	False
DontShow:	False
Aliases:	wi

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Zone

The availability zones for the Interconnect Block. Immutable after create.

Parameter properties

Type:	String[]
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	True
Value from remaining arguments:	False

-ZonePlacementPolicy

Controls the zone placement policy. Accepted value: Any.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	True
Value from remaining arguments:	False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

String

Int64

String

Hashtable

Outputs

Microsoft.Azure.Commands.Compute.Automation.Models.PSInterconnectBlock