Delen via


Revoke-SCIPAddress

Retourneert een toegewezen IP-adres aan de groep met statische IP-adressen.

Syntax

Revoke-SCIPAddress
      [-VMMServer <ServerConnection>]
      [-AllocatedIPAddress] <AllocatedIPAddress>
      [-ReturnToPool <Boolean>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [-Force]
      [<CommonParameters>]

Description

De cmdlet Revoke-SCIPAddress retourneert een toegewezen IP-adres aan de groep met vaste IP-adressen.

Geforceerde verwijdering: dit is alleen van toepassing in een beheerde netwerkcontrolleromgeving. U kunt de parameter Force gebruiken met de cmdlet Revoke-SCIPAddress om een toegewezen openbaar IP-adres te retourneren aan de groep met statische IP-adressen wanneer de netwerkcontroller niet meer online of toegankelijk is.

Typ voor informatie over het toewijzen van IP-adressen Get-Help Grant-SCIPAddress -Detailed.

Voorbeelden

Voorbeeld 1: Retourneer een niet-toegewezen toegewezen IP-adres aan de IP-adresgroep

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]

De eerste opdracht haalt het statische IP-adresgroepobject op met het IPv4-subnet van 10.0.0.0/24 en slaat het object op in de $IPAddressPool variabele.

Met de tweede opdracht worden alle niet-toegewezen TOEGEWEZEN IP-adresobjecten opgehaald voor de groep met statische IP-adressen die zijn opgeslagen in $IPAddressPool en worden de objecten opgeslagen in de $IPAddress variabele.

Met de laatste opdracht wordt het eerste IP-adres ingetrokken dat is opgeslagen in $IPAddress en wordt het adres geretourneerd naar de IP-adresgroep.

Parameters

-AllocatedIPAddress

Hiermee geeft u een IP-adres op dat is toegewezen vanuit een IP-adresgroep.

Type:AllocatedIPAddress
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Force

Hiermee wordt het retourneren van een toegewezen openbaar IP-adres naar de groep met vaste IP-adressen gedwongen wanneer de netwerkcontroller niet meer online of toegankelijk is.

Deze parameter mag alleen worden gebruikt in een beheerde netwerkcontrolleromgeving.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam op. Deze cmdlet werkt namens de gebruiker die met deze parameter wordt opgegeven.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Hiermee geeft u een gebruikersrol op. Gebruik de cmdlet Get-SCUserRole om een gebruikersrol te verkrijgen. Deze cmdlet werkt namens de gebruikersrol die door deze parameter wordt opgegeven.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReturnToPool

Geeft aan of een IP-adres of MAC-adres wordt geretourneerd naar de adresgroep. Deze waarde is standaard ingesteld op $True.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Hiermee geeft u een VMM-serverobject op.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Uitvoerwaarden

CloudDRPairingInfoData

Met deze cmdlet wordt een CloudDRPairingInfoData-object geretourneerd.