Grant-SCIPAddress

Modul:
VirtualMachineManager Module

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

Syntax

Default (Standardwert) 

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

Beschreibung

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

Um eine bestimmte IP-Adresse zu erteilen, 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.

Mit dem zweiten Befehl werden die Objekte des virtuellen Netzwerkadapters für den virtuellen Computer VM01 abgerufen und in der Variablen $vNICs gespeichert.

Mit dem dritten Befehl wird das statische IP-Adresspoolobjekt mit dem Namen Production IP Address Pool abgerufen und in der Variablen $IPPool gespeichert.

Der letzte Befehl ordnet dem ersten in $vNICs gespeicherten virtuellen Netzwerkadapter eine IP-Adresse aus dem statischen IP-Adresspool zu, der in $IPPool gespeichert ist, und gibt VM01 als Beschreibung für die zugeordnete IP-Adresse an.

Parameter

-Description

Gibt eine Beschreibung für das Objekt an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DisableReconcile

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

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

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ExplicitRevokeRequired

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

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

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-GrantToObjectID

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

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Default
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-GrantToObjectType

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

  • VirtualNetworkAdapter
  • VIP
  • HostNetzwerkAdapter
  • LoadBalancer-Konfiguration
  • Virtuelle Maschine
  • HostCluster (Englisch)

Parametereigenschaften

Typ:AllocatedToObjectType
Standardwert:None
Zulässige Werte:VirtualNetworkAdapter, VIP, HostNetworkAdapter, LoadBalancerConfiguration, VirtualMachine, HostCluster, VMSubnet, NetworkService, NATConnection, NetworkGateway, StorageArray, VMNetworkGateway, None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Default
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-IPAddress

Gibt eine IPv4- oder IPv6-Adresse an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Default
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobVariable

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-NetworkController

Gibt einen Netzwerkcontroller an.

Parametereigenschaften

Typ:VirtualSwitchExtensionManager
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PublicIPAddress
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, der durch diesen Parameter angegeben wird.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die durch diesen Parameter angegeben wird.

Parametereigenschaften

Typ:UserRole
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Owner

Gibt die besitzende Person eines VMM-Objekts in Form eines gültigen Domänenbenutzerkontos an.

  • Beispielformat: -Owner "Contoso\PattiFuller"
  • Beispielformat: -Owner "PattiFuller@Contoso"

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PublicIPAddress
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PublicIPAddress

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

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PublicIPAddress
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsynchronously

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-StaticIPAddressPool

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

Parametereigenschaften

Typ:StaticIPAddressPool
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

Default
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-UserRole

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

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

Parametereigenschaften

Typ:UserRole
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PublicIPAddress
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Parametereigenschaften

Typ:ServerConnection
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

CloudDRPairingInfoData

Dieses Cmdlet gibt ein CloudDRPairingInfoData-Objekt zurück.

Hinweise

  • Für dieses Cmdlet ist ein statisches VMM-IP-Adresspoolobjekt erforderlich, das mit dem Cmdlet Get-SCStaticIPAddressPool abgerufen werden kann.