Grant-SCIPAddress

Модуль:
VirtualMachineManager Module

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

Синтаксис

Default (по умолчанию) 

Grant-SCIPAddress
    -StaticIPAddressPool <StaticIPAddressPool>
    -GrantToObjectType <AllocatedToObjectType>
    [-VMMServer <ServerConnection>]
    [-IPAddress <String>]
    [-GrantToObjectID <Guid>]
    [-Description <String>]
    [-ExplicitRevokeRequired <Boolean>]
    [-DisableReconcile <Boolean>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-OnBehalfOfUser <String>]
    [-OnBehalfOfUserRole <UserRole>]
    [<CommonParameters>]

PublicIPAddress 

Grant-SCIPAddress
    -IPAddress <String>
    [-NetworkController <VirtualSwitchExtensionManager>]
    [-UserRole <UserRole>]
    [-VMMServer <ServerConnection>]
    [-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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DisableReconcile

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

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

Свойства параметра

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ExplicitRevokeRequired

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

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

Свойства параметра

Тип:Boolean
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-GrantToObjectID

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

Свойства параметра

Тип:Guid
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Default
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-GrantToObjectType

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

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

Свойства параметра

Тип:AllocatedToObjectType
Default value:None
Допустимые значения:VirtualNetworkAdapter, VIP, HostNetworkAdapter, LoadBalancerConfiguration, VirtualMachine, HostCluster, VMSubnet, NetworkService, NATConnection, NetworkGateway, StorageArray, VMNetworkGateway, None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Default
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IPAddress

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Default
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-JobVariable

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-NetworkController

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

Свойства параметра

Тип:VirtualSwitchExtensionManager
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

PublicIPAddress
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-OnBehalfOfUser

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-OnBehalfOfUserRole

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

Свойства параметра

Тип:UserRole
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Owner

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

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

PublicIPAddress
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PROTipID

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

Свойства параметра

Тип:Guid
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PublicIPAddress

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

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

PublicIPAddress
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RunAsynchronously

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-StaticIPAddressPool

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

Свойства параметра

Тип:StaticIPAddressPool
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Default
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-UserRole

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

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

Свойства параметра

Тип:UserRole
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

PublicIPAddress
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VMMServer

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

Свойства параметра

Тип:ServerConnection
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

CloudDRPairingInfoData

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

Примечания

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