Grant-SCIPAddress
Aloca um endereço IP estático ou virtual de um pool de endereços especificado.
Syntax
Grant-SCIPAddress
[-VMMServer <ServerConnection>]
-StaticIPAddressPool <StaticIPAddressPool>
-GrantToObjectType <AllocatedToObjectType>
[-IPAddress <String>]
[-GrantToObjectID <Guid>]
[-Description <String>]
[-ExplicitRevokeRequired <Boolean>]
[-DisableReconcile <Boolean>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Grant-SCIPAddress
[-NetworkController <VirtualSwitchExtensionManager>]
[-UserRole <UserRole>]
[-VMMServer <ServerConnection>]
-IPAddress <String>
[-Description <String>]
[-PublicIPAddress]
[-Owner <String>]
[-ExplicitRevokeRequired <Boolean>]
[-DisableReconcile <Boolean>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Description
O cmdlet Grant-SCIPAddress aloca endereços IP estáticos e IP virtual de um pool de endereços especificado.
Para conceder um endereço IP específico, use o parâmetro IPAddress . Caso contrário, o VMM (Virtual Machine Manager) escolherá o endereço IP no pool de endereços.
Exemplos
Exemplo 1: Alocar um endereço IP
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $vNICs = $VM.VirtualNetworkAdapters
PS C:\> $IPPool = Get-SCStaticIPAddressPool -Name "Production IP Address Pool"
PS C:\> Grant-SCIPAddress -StaticIPAddressPool $IPPool -GrantToObjectType VirtualNetworkAdapter -GrantToObjectID $vNICs[0].ID -Description $VM.NameO primeiro comando obtém o objeto de máquina virtual chamado VM01 e armazena o objeto na variável $VM.
O segundo comando obtém os objetos do adaptador de rede virtual da VM01 da máquina virtual e armazena os objetos na variável $vNICs.
O terceiro comando obtém o objeto do pool de endereços IP estático chamado Pool de Endereços IP de Produção e armazena o objeto na variável $IPPool.
O último comando aloca um endereço IP do pool de endereços IP estático armazenado em $IPPool para o primeiro adaptador de rede virtual armazenado em $vNICs e fornece a VM01 como a descrição do endereço IP alocado.
Parâmetros
-Description
Especifica uma descrição para o objeto.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableReconcile
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExplicitRevokeRequired
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GrantToObjectID
Especifica a ID de um objeto ao qual um endereço IP alocado ou endereço MAC é atribuído.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GrantToObjectType
Especifica um valor para AllocatedToObjectType ao qual um endereço IP alocado ou endereço IP virtual é atribuído. Os valores aceitáveis para esse parâmetro são:
- VirtualNetworkAdapter
- VIP
- HostNetworkAdapter
- LoadBalancerConfiguration
- VirtualMachine
- HostCluster
| Type: | AllocatedToObjectType |
| Accepted values: | VirtualNetworkAdapter, VIP, HostNetworkAdapter, LoadBalancerConfiguration, VirtualMachine, HostCluster, VMSubnet, NetworkService, NATConnection, NetworkGateway, StorageArray, VMNetworkGateway, None |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IPAddress
Especifica um endereço IPv4 ou IPv6.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Especifica que o andamento do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NetworkController
Especifica um controlador de rede.
| Type: | VirtualSwitchExtensionManager |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Owner
Especifica o proprietário de um objeto do VMM na forma de uma conta de usuário de domínio válido.
- Formato de exemplo:
-Owner "Contoso\PattiFuller" - Formato de exemplo:
-Owner "PattiFuller@Contoso"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PublicIPAddress
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StaticIPAddressPool
Especifica um pool de endereços IP do qual você pode atribuir endereços IP estáticos.
| Type: | StaticIPAddressPool |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserRole
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Especifica um objeto de servidor do VMM.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Saídas
CloudDRPairingInfoData
Esse cmdlet retorna um objeto CloudDRPairingInfoData .
Observações
- Esse cmdlet requer um objeto de pool de endereços IP estático do VMM, que pode ser recuperado usando o cmdlet Get-SCStaticIPAddressPool .