Add-AzVMNetworkInterfaceConfiguration
Adiciona uma configuração implícita de interface de rede a uma máquina virtual.
Sintaxe
Default (Predefinição)
Add-AzVMNetworkInterfaceConfiguration
[-VM] <PSVirtualMachine>
[-Name <String>]
[-Primary]
[-IpConfiguration <VirtualMachineNetworkInterfaceIPConfiguration[]>]
[-NetworkApiVersion <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrição
O cmdlet Add-AzVMNetworkInterfaceConfiguration adiciona uma configuração implícita de interface de rede a um objeto de máquina virtual (VM) configurável.
Inicializa o perfil de rede quando necessário e preserva as configurações existentes da interface de rede.
Exemplos
$serviceTagResourceId = '/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/firstPartyServiceTags/myServiceTag'
$subnetId = '/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Network/virtualNetworks/myVNet/subnets/mySubnet'
$ipTag = New-AzVMIpTagConfig -IpTagType 'FirstPartyUsage' -FirstPartyServiceTagId $serviceTagResourceId
$ipConfig = New-AzVMIpConfig -Name 'ipConfig' -SubnetId $subnetId -PublicIPAddressConfigurationName 'publicIpConfig' -IpTag $ipTag
$vmConfig = New-AzVMConfig -VMName 'myVM' -VMSize 'Standard_D2s_v5'
$vmConfig = Add-AzVMNetworkInterfaceConfiguration -VM $vmConfig -Name 'nicConfig' -Primary -IpConfiguration $ipConfig -NetworkApiVersion '2022-11-01'
Este exemplo adiciona uma interface de rede implícita e uma configuração de IP público aninhada a um objeto de configuração VM.
Parâmetros
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False Aliases: Cf.
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-DefaultProfile
As credenciais, conta, inquilino e subscrição usados para comunicação com o Azure.
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-IpConfiguration
Especifica as configurações de IP a adicionar à configuração da interface de rede.
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-Name
Especifica o nome da configuração da interface de rede.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-NetworkApiVersion
Especifica a versão da API de rede Microsoft. Usada para criar os recursos implícitos de rede.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-Primary
Especifica se esta é a configuração principal da interface de rede.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-VM
Especifica o objeto VM configurável a atualizar.
Crie o objeto com o New-AzVMConfig .
Propriedades dos parâmetros
Tipo: PSVirtualMachine
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False Aliases: VirtualMachine
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: True Valor do pipeline: True Valor do pipeline por nome de propriedade: True Valor dos restantes argumentos: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None Suporta carateres universais: False NãoMostrar: False Aliases: Wi
Conjuntos de parâmetros
(All)
Posto: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas
