Grant-SCIPAddress

Модуль:

virtualmachinemanager

Выделяет статический или виртуальный IP-адрес из указанного пула адресов.

Синтаксис

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>]

Описание

Командлет Grant-SCIPAddress выделяет статические IP-адреса и виртуальные IP-адреса из указанного пула адресов.

Чтобы предоставить определенный IP-адрес, используйте параметр IPAddress . В противном случае диспетчер виртуальных машин (VMM) выбирает IP-адрес из пула адресов.

Примеры

Пример 1: Выделение 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.Name

Первая команда получает объект виртуальной машины с именем VM01 и сохраняет объект в переменной $VM.

Вторая команда получает объекты виртуального сетевого адаптера для виртуальной машины VM01 и сохраняет объекты в переменной $vNICs.

Третья команда получает объект пула статических IP-адресов с именем Production IP Address Pool и сохраняет объект в переменной $IPPool.

Последняя команда выделяет IP-адрес из пула статических IP-адресов, хранящегося в $IPPool, первому виртуальному сетевому адаптеру, хранящемуся в $vNICs, и предоставляет VM01 в качестве описания для выделенного IP-адреса.

Параметры

-Description

Задает описание объекта.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DisableReconcile

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ExplicitRevokeRequired

Тип:	Boolean
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-GrantToObjectID

Указывает идентификатор объекта, которому назначен выделенный IP-адрес или MAC-адрес.

Тип:	Guid
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-GrantToObjectType

Указывает значение для AllocatedToObjectType, которому назначается выделенный IP-адрес или виртуальный IP-адрес. Допустимые значения для этого параметра:

• Виртуальный сетевой адаптер
• Виртуальный IP-адрес
• HostNetworkAdapter
• LoadBalancerConfiguration (Конфигурация LoadBalancer)
• Виртуальная машина
• Хосткластер

Тип:	AllocatedToObjectType
Допустимые значения:	VirtualNetworkAdapter, VIP, HostNetworkAdapter, LoadBalancerConfiguration, VirtualMachine, HostCluster, VMSubnet, NetworkService, NATConnection, NetworkGateway, StorageArray, VMNetworkGateway, None
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-IPAddress

Указывает адрес IPv4 или IPv6.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-JobVariable

Указывает, что ход выполнения задания отслеживается и хранится в переменной с именем этого параметра.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-NetworkController

Указывает сетевой контроллер.

Тип:	VirtualSwitchExtensionManager
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-OnBehalfOfUser

Указывает имя пользователя. Этот командлет работает от имени пользователя, указанного в этом параметре.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-OnBehalfOfUserRole

Указывает роль пользователя. Чтобы получить роль пользователя, используйте командлет Get-SCUserRole . Этот командлет работает от имени роли пользователя, указанной в этом параметре.

Тип:	UserRole
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Owner

Указывает владельца объекта VMM в виде допустимой учетной записи пользователя домена.

• Пример формата: -Owner "Contoso\PattiFuller"
• Пример формата: -Owner "PattiFuller@Contoso"

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PROTipID

Указывает идентификатор подсказки по оптимизации производительности и ресурсов (подсказка PRO), активировав это действие. Этот параметр позволяет проверять советы PRO.

Тип:	Guid
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PublicIPAddress

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RunAsynchronously

Указывает, что задание выполняется асинхронно, чтобы элемент управления сразу же возвращал командную оболочку.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-StaticIPAddressPool

Указывает пул IP-адресов, из которого можно назначать статические IP-адреса.

Тип:	StaticIPAddressPool
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-UserRole

Тип:	UserRole
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-VMMServer

Указывает объект сервера VMM.

Тип:	ServerConnection
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

Выходные данные

CloudDRPairingInfoData

Этот командлет возвращает объект CloudDRPairingInfoData .

Примечания

• Для этого командлета требуется объект пула статических IP-адресов VMM, который можно получить с помощью командлета Get-SCStaticIPAddressPool .

Связанные ссылки

• Get-SCIPAddress
• Get-SCVirtualMachine
• Get-SCStaticIPAddressPool
• Revoke-SCIPAddress
• Set-SCIPAddress