Condividi tramite

Add-AzVirtualNetworkSubnetConfig

  • Riferimento
Modulo:
Az.Network

Aggiunge una configurazione di subnet a una rete virtuale.

Sintassi

Add-AzVirtualNetworkSubnetConfig
   -Name <String>
   -VirtualNetwork <PSVirtualNetwork>
   -AddressPrefix <String[]>
   [-NetworkSecurityGroup <PSNetworkSecurityGroup>]
   [-RouteTable <PSRouteTable>]
   [-InputObject <PSNatGateway>]
   [-ServiceEndpoint <String[]>]
   [-NetworkIdentifier <PSResourceId>]
   [-ServiceEndpointConfig <PSServiceEndpoint[]>]
   [-ServiceEndpointPolicy <PSServiceEndpointPolicy[]>]
   [-Delegation <PSDelegation[]>]
   [-PrivateEndpointNetworkPoliciesFlag <String>]
   [-PrivateLinkServiceNetworkPoliciesFlag <String>]
   [-IpAllocation <PSIpAllocation[]>]
   [-DefaultOutboundAccess <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzVirtualNetworkSubnetConfig
   -Name <String>
   -VirtualNetwork <PSVirtualNetwork>
   -AddressPrefix <String[]>
   [-NetworkSecurityGroupId <String>]
   [-RouteTableId <String>]
   [-ResourceId <String>]
   [-ServiceEndpoint <String[]>]
   [-NetworkIdentifier <PSResourceId>]
   [-ServiceEndpointConfig <PSServiceEndpoint[]>]
   [-ServiceEndpointPolicy <PSServiceEndpointPolicy[]>]
   [-Delegation <PSDelegation[]>]
   [-PrivateEndpointNetworkPoliciesFlag <String>]
   [-PrivateLinkServiceNetworkPoliciesFlag <String>]
   [-IpAllocation <PSIpAllocation[]>]
   [-DefaultOutboundAccess <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Descrizione

Il cmdlet Add-AzVirtualNetworkSubnetConfig aggiunge una configurazione della subnet a una rete virtuale di Azure esistente.

Esempio

Esempio 1: Aggiungere una subnet a una rete virtuale esistente

New-AzResourceGroup -Name TestResourceGroup -Location centralus
    $frontendSubnet = New-AzVirtualNetworkSubnetConfig -Name frontendSubnet -AddressPrefix "10.0.1.0/24"
    $virtualNetwork = New-AzVirtualNetwork -Name MyVirtualNetwork -ResourceGroupName TestResourceGroup -Location centralus -AddressPrefix "10.0.0.0/16" -Subnet $frontendSubnet
    Add-AzVirtualNetworkSubnetConfig -Name backendSubnet -VirtualNetwork $virtualNetwork -AddressPrefix "10.0.2.0/24"
    $virtualNetwork | Set-AzVirtualNetwork

In questo esempio viene prima creato un gruppo di risorse come contenitore delle risorse da creare. Crea quindi una configurazione della subnet e la usa per creare una rete virtuale. Add-AzVirtualNetworkSubnetConfig viene quindi usato per aggiungere una subnet alla rappresentazione in memoria della rete virtuale. Il comando Set-AzVirtualNetwork aggiorna la rete virtuale esistente con la nuova subnet.

Esempio 2: Aggiungere una delega a una subnet da aggiungere a una rete virtuale esistente

$vnet = Get-AzVirtualNetwork -Name "myVNet" -ResourceGroupName "myResourceGroup"
$delegation = New-AzDelegation -Name "myDelegation" -ServiceName "Microsoft.Sql/servers"
Add-AzVirtualNetworkSubnetConfig -Name "mySubnet" -VirtualNetwork $vnet -AddressPrefix "10.0.2.0/24" -Delegation $delegation | Set-AzVirtualNetwork

In questo esempio viene prima di tutto recuperata una rete virtuale esistente. Crea quindi un oggetto delega in memoria. Infine, crea una nuova subnet con tale delega aggiunta alla rete virtuale. La configurazione modificata viene quindi inviata al server.

Parametri

-AddressPrefix

Specifica un intervallo di indirizzi IP per una configurazione della subnet.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultOutboundAccess

Connettività in uscita predefinita per tutte le macchine virtuali nella subnet

Tipo:Nullable<T>[Boolean]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Delegation

Elenco di servizi che dispongono dell'autorizzazione per eseguire operazioni su questa subnet.

Tipo:PSDelegation[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-InputObject

Specifica il gateway NAT associato alla configurazione della subnet.

Tipo:PSNatGateway
Alias:NatGateway
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-IpAllocation

Specifica IpAllocations per una subnet.

Tipo:PSIpAllocation[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica il nome della configurazione della subnet da aggiungere.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NetworkIdentifier

Valore networkIdentifier per ServiceEndpoint

Tipo:PSResourceId
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-NetworkSecurityGroup

Specifica un oggetto NetworkSecurityGroup . Questo cmdlet aggiunge una configurazione della subnet di rete virtuale all'oggetto specificato da questo parametro.

Tipo:PSNetworkSecurityGroup
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-NetworkSecurityGroupId

Specifica l'ID di un gruppo di sicurezza di rete.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PrivateEndpointNetworkPoliciesFlag

Configurare per abilitare o disabilitare l'applicazione dei criteri di rete nell'endpoint privato nella subnet. Il valore predefinito è Disabled.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-PrivateLinkServiceNetworkPoliciesFlag

Configurare per abilitare o disabilitare l'applicazione dei criteri di rete nel servizio di collegamento privato nella subnet.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ResourceId

Specifica l'ID della risorsa gateway NAT associata alla configurazione della subnet.

Tipo:String
Alias:NatGatewayId
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-RouteTable

Tipo:PSRouteTable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-RouteTableId

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ServiceEndpoint

Valore dell'endpoint di servizio

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ServiceEndpointConfig

Endpoint servizio con valore NetworkIdentifier

Tipo:PSServiceEndpoint[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ServiceEndpointPolicy

Criteri degli endpoint di servizio

Tipo:PSServiceEndpointPolicy[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-VirtualNetwork

Specifica l'oggetto VirtualNetwork in cui aggiungere una configurazione della subnet.

Tipo:PSVirtualNetwork
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

PSVirtualNetwork

String

PSNetworkSecurityGroup

PSRouteTable

String[]

PSServiceEndpointPolicy[]

PSDelegation[]

Output

PSVirtualNetwork