Compartilhar via

Set-SCIPAddress

  • Referência
Módulo:
VirtualMachineManager

Modifica um endereço IP alocado atribuindo o endereço IP a um objeto ou atualizando a descrição do endereço IP.

Sintaxe

Set-SCIPAddress
   [-UserRole <UserRole>]
   [-VMMServer <ServerConnection>]
   [-AllocatedIPAddress] <AllocatedIPAddress>
   [-GrantToObjectID <Guid>]
   [-Description <String>]
   [-Owner <String>]
   [-ExplicitRevokeRequired <Boolean>]
   [-DisableReconcile <Boolean>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Set-SCIPAddress modifica um endereço IP alocado. Você pode usar Set-SCIPAddress para atribuir um endereço IP alocado a um objeto usando o parâmetro GrantToObjectID .

Exemplos

Exemplo 1: Atribuir um endereço IP alocado a um IP virtual do balanceador de carga

PS C:\> $VIP = Get-SCLoadBalancerVIP -Name "LoadBalancerVIP01"
PS C:\> $IPAddressPool = Get-SCStaticIPAddressPool -IPv4 -Subnet "10.0.0.0/24"
PS C:\> $IPAddress = Get-SCIPAddress -StaticIPAddressPool $IPAddressPool -Unassigned
PS C:\> Set-SCIPAddress -AllocatedIPAddress $IPAddress[0] -GrantToObjectID $VIP.ID

O primeiro comando obtém o objeto IP virtual do balanceador de carga chamado LoadBalancerVIP01 e armazena o objeto na variável $VIP.

O segundo comando obtém o objeto do pool de endereços IP estático com a sub-rede IPv4 especificada e armazena o objeto na variável $IPAddressPool.

O terceiro comando obtém os objetos de endereço IP não atribuídos para o pool de endereços IP estático armazenado em $IPAddressPool e armazena os objetos na variável $IPAddress.

O último comando atribui o primeiro endereço IP não atribuído dos endereços armazenados em $IPAddress à ID do balanceador de carga virtual armazenada em $VIP.ID.

Parâmetros

-AllocatedIPAddress

Especifica um endereço IP que foi alocado de um pool de endereços IP.

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

-Description

Especifica uma descrição para o endereço IP.

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

-DisableReconcile

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

-ExplicitRevokeRequired

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

-GrantToObjectID

Especifica a ID de um objeto ao qual um endereço IP alocado ou endereço MAC é atribuído.

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

-JobVariable

Especifica que o progresso do trabalho é acompanhado e armazenado na variável nomeada 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

-Owner

Especifica o proprietário de um objeto VMM na forma de uma conta de usuário de domínio válida.

  • Formato de exemplo: -Owner "Contoso\PattiFuller"
  • Formato de exemplo: -Owner "PattiFuller@Contoso"
Tipo:String
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

-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

-UserRole

Tipo:UserRole
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

Saídas

CloudDRPairingInfoData

Esse cmdlet retorna um objeto CloudDRPairingInfoData.