Revoke-SCIPAddress
Gibt eine zugewiesene 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 zugewiesene IP-Adresse an den statischen IP-Adresspool zurück.
Erzwungene Entfernung: Dies gilt nur in einer verwalteten Netzwerkcontrollerumgebung. Sie können den Parameter Force mit dem Cmdlet "Revoke-SCIPAddress " verwenden, um eine zugewiesene öffentliche IP-Adresse an den statischen IP-Adresspool zurückzugeben, wenn der Netzwerkcontroller nicht mehr online ist oder darauf zugreifen kann.
Geben Sie informationen zum Zuordnen von IP-Adressen ein Get-Help Grant-SCIPAddress -Detailed
.
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 $IPAddress Variablen.
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 von einem IP-Adresspool zugewiesen wurde.
Type: | AllocatedIPAddress |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUser
Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, den dieser Parameter angibt.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUserRole
Gibt eine Benutzerrolle an. Um eine Benutzerrolle abzurufen, verwenden Sie das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die dieser Parameter angibt.
Type: | UserRole |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReturnToPool
Gibt an, ob eine IP-Adresse oder EINE MAC-Adresse an den Adresspool zurückgegeben wird. Dieser Wert ist standardmäßig auf $True festgelegt.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMMServer
Gibt ein VMM-Serverobjekt an.
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Ausgaben
CloudDRPairingInfoData
Dieses Cmdlet gibt ein CloudDRPairingInfoData-Objekt zurück.