Freigeben über

Grant-SCIPAddress

  • Referenz
Modul:
VirtualMachineManager

Weist eine statische oder virtuelle IP-Adresse aus einem angegebenen Adresspool zu.

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

Beschreibung

Das Cmdlet Grant-SCIPAddress weist statische IP- und virtuelle IP-Adressen aus einem angegebenen Adresspool zu.

Um eine bestimmte IP-Adresse zu gewähren, verwenden Sie den parameter IPAddress. Andernfalls wählt Virtual Machine Manager (VMM) die IP-Adresse aus dem Adresspool aus.

Beispiele

Beispiel 1: Zuweisen einer IP-Adresse

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

Der erste Befehl ruft das Objekt des virtuellen Computers mit dem Namen VM01 ab und speichert das Objekt in der $VM Variablen.

Der zweite Befehl ruft die Objekte des virtuellen Netzwerkadapters für virtuelle Computer VM01 ab und speichert die Objekte in der $vNICs Variablen.

Der dritte Befehl ruft das statische IP-Adresspoolobjekt namens "Produktions-IP-Adresspool" ab und speichert das Objekt in der $IPPool Variablen.

Der letzte Befehl weist eine IP-Adresse aus dem statischen IP-Adresspool zu, der in $IPPool gespeichert ist, dem ersten virtuellen Netzwerkadapter, der in $vNICs gespeichert ist, und stellt VM01 als Beschreibung für die zugewiesene IP-Adresse bereit.

Parameter

-Description

Gibt eine Beschreibung für das Objekt an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableReconcile

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ExplicitRevokeRequired

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-GrantToObjectID

Gibt die ID eines Objekts an, dem eine zugeordnete IP-Adresse oder MAC-Adresse zugewiesen ist.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-GrantToObjectType

Gibt einen Wert für AssignedToObjectType an, dem eine zugeordnete IP-Adresse oder virtuelle IP-Adresse zugewiesen ist. Die zulässigen Werte für diesen Parameter sind:

  • VirtualNetworkAdapter
  • VIP
  • HostNetworkAdapter
  • LoadBalancerConfiguration
  • VirtualMachine
  • HostCluster
Typ:AllocatedToObjectType
Zulässige Werte:VirtualNetworkAdapter, VIP, HostNetworkAdapter, LoadBalancerConfiguration, VirtualMachine, HostCluster, VMSubnet, NetworkService, NATConnection, NetworkGateway, StorageArray, VMNetworkGateway, None
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IPAddress

Gibt eine IPv4- oder IPv6-Adresse an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NetworkController

Gibt einen Netzwerkcontroller an.

Typ:VirtualSwitchExtensionManager
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag des Benutzers ausgeführt, den dieser Parameter angibt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das cmdlet Get-SCUserRole. Dieses Cmdlet wird im Auftrag der Benutzerrolle ausgeführt, die dieser Parameter angibt.

Typ:UserRole
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Owner

Gibt den Besitzer eines VMM-Objekts in Form eines gültigen Domänenbenutzerkontos an.

  • Beispielformat: -Owner "Contoso\PattiFuller"
  • Beispielformat: -Owner "PattiFuller@Contoso"
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

Typ:Guid
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PublicIPAddress

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StaticIPAddressPool

Gibt einen IP-Adresspool an, aus dem Sie statische IP-Adressen zuweisen können.

Typ:StaticIPAddressPool
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserRole

Typ:UserRole
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Typ:ServerConnection
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

CloudDRPairingInfoData

Dieses Cmdlet gibt ein CloudDRPairingInfoData--Objekt zurück.

Hinweise

  • Für dieses Cmdlet ist ein statisches IP-Adresspoolobjekt erforderlich, das mithilfe des Cmdlets Get-SCStaticIPAddressPool abgerufen werden kann.