Freigeben über

Set-SCStaticIPAddressPool

  • Referenz
Modul:
VirtualMachineManager

Ändert einen statischen IP-Adresspool, der einer oder mehreren Hostgruppen zugeordnet ist.

Syntax

Set-SCStaticIPAddressPool
   [-VMMServer <ServerConnection>]
   [-StaticIPAddressPool] <StaticIPAddressPool>
   [-Name <String>]
   [-Description <String>]
   [-DNSSearchSuffix <String[]>]
   [-DNSServer <String[]>]
   [-PxeServerAddress <String[]>]
   [-DNSSuffix <String>]
   [-IPAddressRangeStart <String>]
   [-IPAddressRangeEnd <String>]
   [-IPAddressReservedSet <String>]
   [-VIPAddressSet <String>]
   [-EnableNetBIOS <Boolean>]
   [-DefaultGateway <DefaultGateway[]>]
   [-NetworkRoute <SubnetNetworkRoute[]>]
   [-WINSServer <String[]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Mit dem Cmdlet Set-SCStaticIPAddressPool cmdlet wird ein statischer IP-Adresspool (Virtual Machine Manager, VMM) geändert. Ein statischer IP-Adresspool kann einer oder mehreren logischen Netzwerkdefinitionen zugeordnet werden.

Beispiele

Beispiel 1: Hinzufügen von DNS-Servern zu einem statischen IP-Adresspool

PS C:\> $HostGroup = Get-SCVMHostGroup | where { $_.Path -eq "All Hosts\HostGroup02\Production" }
PS C:\> $IPPool = Get-SCStaticIPAddressPool -IPv4 -Subnet "10.0.0.0/24" -VMHostGroup $HostGroup -Name "Production IP Address Pool"
PS C:\> $DNSServerIPAddress = $IPPool.DNSServers
PS C:\> $DNSServerIPAddress += "10.0.0.1"
PS C:\> Set-SCStaticIPAddressPool -StaticIPAddressPool $IPPool -DNSServer $DNSServerIPAddress

Der erste Befehl ruft die Hostgruppe mit dem Pfad "All Hosts\HostGroup02\Production" ab und speichert diese Gruppe in der variablen $HostGroup.

Der zweite Befehl ruft den statischen Adresspool namens "Produktions-IP-Adresspool" für die in $HostGroup gespeicherte Hostgruppe mithilfe der IPv4-Adresse für das angegebene Subnetz ab. Der Befehl speichert den Pool in der variablen $IPPool.

Der dritte Befehl ruft den DNS-Server für den in $IPPool gespeicherten IP-Adresspool ab, und der vierte Befehl fügt dem adressarray, das in der variablen $DNSServerIPAddress gespeichert ist, eine Adresse hinzu.

Der letzte Befehl aktualisiert den in $IPPool gespeicherten IP-Adresspool mit dem adressarray, das in $DNSServerIPAddress gespeichert ist.

Parameter

-DefaultGateway

Gibt ein Array von Standardgatewayobjekten an.

Typ:DefaultGateway[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt eine Beschreibung für den Adresspool an.

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

-DNSSearchSuffix

Gibt ein Array von Zeichenfolgen an, die an einen Hostnamen angefügt werden, um eine DNS-Adresse aufzulösen.

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

-DNSServer

Gibt ein Array von IP-Adressen von DNS-Servern an. Gültige Formate sind: IPv4- und IPv6-Adressen.

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

-DNSSuffix

Gibt das standardmäßige DNS-Suffix an, das einem Adapter zugeordnet ist.

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

-EnableNetBIOS

Gibt an, ob NetBIOS über TCP/IP für einen Adapter aktiviert werden soll.

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

-IPAddressRangeEnd

Gibt die letzte IP-Adresse in einem Bereich von IP-Adressen an. Wird mit dem parameter IPAddressRangeStart verwendet.

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

-IPAddressRangeStart

Gibt die erste IP-Adresse in einem Bereich von IP-Adressen an. Wird mit dem parameter IPAddressRangeEnd verwendet.

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

-IPAddressReservedSet

Gibt einen Satz von IP-Adressen in einem IP-Subnetz an, das für andere Zwecke reserviert ist.

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

-JobVariable

Gibt eine Variable an, in der der Auftragsfortschritt nachverfolgt und gespeichert wird.

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

-Name

Gibt den Namen für den Adresspool an.

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

-NetworkRoute

Gibt ein Array von Netzwerkrouten an.

Typ:SubnetNetworkRoute[]
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

-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

-PxeServerAddress

Gibt ein Array von PXE-Server-IP-Adressen an.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
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 den statischen IP-Adresspool an, den dieses Cmdlet ändert.

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

-VIPAddressSet

Gibt einen Satz von IP-Adressen in einem IP-Subnetz an, das für die Konfiguration virtueller IPs (VIPs) in Lastenausgleichsmodulen reserviert ist.

Typ:String
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

-WINSServer

Gibt ein Array von IP-Adressen von Windows Internet Name Service (WINS)-Servern an. Gültige Formate sind: IPv4- und IPv6-Adressen.

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

Ausgaben

StaticIPAddressPool

Dieses Cmdlet gibt ein StaticIPAddressPool-Objekt zurück.