Revoke-SCIPAddress
Gibt eine zugeordnete IP-Adresse an den statischen IP-Adresspool zurück.
Syntax
Revoke-SCIPAddress
[-VMMServer <ServerConnection>]
[-AllocatedIPAddress] <AllocatedIPAddress>
[-ReturnToPool <Boolean>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[-Force]
[<CommonParameters>]
Beschreibung
Das Cmdlet Revoke-SCIPAddress gibt eine zugeordnete IP-Adresse an den statischen IP-Adresspool zurück.
Erzwungenes Entfernen: Dies gilt nur in einer verwalteten Netzwerkcontrollerumgebung. Sie können den Parameter Force mit dem Cmdlet Revoke-SCIPAddress verwenden, um eine zugeordnete öffentliche IP-Adresse an den statischen IP-Adresspool zurückzugeben, wenn der Netzwerkcontroller nicht mehr online oder zugänglich ist.
Geben Sie Get-Help Grant-SCIPAddress -Detailed
ein, um Informationen zum Zuordnen von IP-Adressen zu erstellen.
Beispiele
Beispiel 1: Zurückgeben einer nicht zugewiesenen zugewiesenen IP-Adresse an den IP-Adresspool
PS C:\> $IPAddressPool = Get-SCStaticIPAddressPool -IPv4 -Subnet "10.0.0.0/24"
PS C:\> $IPAddress = Get-SCIPAddress -StaticIPAddressPool $IPAddressPool -Unassigned
PS C:\> Revoke-SCIPAddress -AllocatedIPAddress $IPAddress[0]
Der erste Befehl ruft das statische IP-Adresspoolobjekt mit dem IPv4-Subnetz von 10.0.0.0/24 ab und speichert das Objekt in der $IPAddressPool Variablen.
Der zweite Befehl ruft alle nicht zugewiesenen zugewiesenen IP-Adressobjekte für den statischen IP-Adresspool ab, der in $IPAddressPool gespeichert ist, und speichert die Objekte in der variablen $IPAddress.
Der letzte Befehl widerruft die erste in $IPAddress gespeicherte IP-Adresse und gibt die Adresse an den IP-Adresspool zurück.
Parameter
-AllocatedIPAddress
Gibt eine IP-Adresse an, die aus einem IP-Adresspool zugewiesen wurde.
Typ: | AllocatedIPAddress |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Force
Erzwingt die Rückgabe einer zugewiesenen öffentlichen IP-Adresse an den statischen IP-Adresspool, wenn der Netzwerkcontroller nicht mehr online oder zugänglich ist.
Dieser Parameter sollte nur in einer verwalteten Netzwerkcontrollerumgebung verwendet werden.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
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 |
-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 |
-ReturnToPool
Gibt an, ob eine IP-Adresse oder MAC-Adresse an den Adresspool zurückgegeben wird. Dieser Wert ist standardmäßig auf $True festgelegt.
Typ: | Boolean |
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 |
-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.