Compartilhar via

Set-SCStaticIPAddressPool

  • Referência
Módulo:
VirtualMachineManager

Modifica um pool de endereços IP estático associado a um ou mais grupos de host.

Sintaxe

Set-SCStaticIPAddressPool
   [-VMMServer <ServerConnection>]
   [-StaticIPAddressPool] <StaticIPAddressPool>
   [-Name <String>]
   [-Description <String>]
   [-DNSSearchSuffix <String[]>]
   [-DNSServer <String[]>]
   [-PxeServerAddress <String[]>]
   [-DNSSuffix <String>]
   [-IPAddressRangeStart <String>]
   [-IPAddressRangeEnd <String>]
   [-IPAddressReservedSet <String>]
   [-VIPAddressSet <String>]
   [-EnableNetBIOS <Boolean>]
   [-DefaultGateway <DefaultGateway[]>]
   [-NetworkRoute <SubnetNetworkRoute[]>]
   [-WINSServer <String[]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

O cmdlet Set-SCStaticIPAddressPool modifica um pool de endereços IP estáticos do VMM (Virtual Machine Manager). Um pool de endereços IP estático pode ser associado a uma ou mais definições de rede lógicas.

Exemplos

Exemplo 1: Adicionar servidores DNS a um pool de endereços IP estáticos

PS C:\> $HostGroup = Get-SCVMHostGroup | where { $_.Path -eq "All Hosts\HostGroup02\Production" }
PS C:\> $IPPool = Get-SCStaticIPAddressPool -IPv4 -Subnet "10.0.0.0/24" -VMHostGroup $HostGroup -Name "Production IP Address Pool"
PS C:\> $DNSServerIPAddress = $IPPool.DNSServers
PS C:\> $DNSServerIPAddress += "10.0.0.1"
PS C:\> Set-SCStaticIPAddressPool -StaticIPAddressPool $IPPool -DNSServer $DNSServerIPAddress

O primeiro comando obtém o grupo de hosts que tem o caminho Todos os Hosts\HostGroup02\Production e armazena esse grupo na variável $HostGroup.

O segundo comando obtém o pool de endereços estáticos chamado Pool de Endereços IP de Produção para o grupo de hosts armazenado em $HostGroup, usando o endereço IPv4 para a sub-rede especificada. O comando armazena o pool na variável $IPPool.

O terceiro comando obtém o servidor DNS para o pool de endereços IP armazenado em $IPPool e, em seguida, o quarto comando adiciona um endereço à matriz de endereços armazenada na variável $DNSServerIPAddress.

O último comando atualiza o pool de endereços IP armazenado em $IPPool com a matriz de endereços armazenada em $DNSServerIPAddress.

Parâmetros

-DefaultGateway

Especifica uma matriz de objetos de gateway padrão.

Tipo:DefaultGateway[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifica uma descrição para o pool de endereços.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DNSSearchSuffix

Especifica uma matriz de cadeias de caracteres que são acrescentadas a um nome de host para resolver um endereço DNS.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DNSServer

Especifica uma matriz de endereços IP de servidores DNS. Os formatos válidos são: endereços IPv4 e IPv6.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DNSSuffix

Especifica o sufixo DNS padrão associado a um adaptador.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableNetBIOS

Indica se o NetBIOS deve ser habilitado por TCP/IP para um adaptador.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IPAddressRangeEnd

Especifica o último endereço IP em um intervalo de endereços IP. Use com o parâmetro IPAddressRangeStart.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IPAddressRangeStart

Especifica o primeiro endereço IP em um intervalo de endereços IP. Use com o parâmetro IPAddressRangeEnd.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IPAddressReservedSet

Especifica um conjunto de endereços IP em uma sub-rede IP reservada para outro uso.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobVariable

Especifica uma variável na qual o progresso do trabalho é acompanhado e armazenado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome do pool de endereços.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NetworkRoute

Especifica uma matriz de rotas de rede.

Tipo:SubnetNetworkRoute[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUser

Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Tipo:UserRole
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PxeServerAddress

Especifica uma matriz de endereços IP do servidor PXE.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StaticIPAddressPool

Especifica o pool de endereços IP estáticos que este cmdlet modifica.

Tipo:StaticIPAddressPool
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VIPAddressSet

Especifica um conjunto de endereços IP em uma sub-rede IP reservada para configurar VIPs (IPs virtuais) em balanceadores de carga.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VMMServer

Especifica um objeto de servidor do VMM.

Tipo:ServerConnection
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WINSServer

Especifica uma matriz de endereços IP de servidores WINS (Windows Internet Name Service). Os formatos válidos são: endereços IPv4 e IPv6.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

StaticIPAddressPool

Esse cmdlet retorna um objeto StaticIPAddressPool.