Sdílet prostřednictvím

Revoke-SCIPAddress

  • Reference
Modul:
VirtualMachineManager

Vrátí přidělenou IP adresu fondu statických IP adres.

Syntaxe

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

Description

Rutina Revoke-SCIPAddress vrátí přidělenou IP adresu fondu statických IP adres.

Vynucené odebrání: To platí jenom v prostředí spravovaném síťovým adaptérem. Pomocí parametru Force s rutinou Revoke-SCIPAddress můžete vrátit přidělenou veřejnou IP adresu fondu statických IP adres, pokud už síťový adaptér není online nebo přístupný.

Informace o přidělování IP adres zadejte Get-Help Grant-SCIPAddress -Detailed.

Příklady

Příklad 1: Vrácení nepřiřazené přidělené IP adresy fondu IP adres

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]

První příkaz získá objekt fondu statických IP adres s podsítí IPv4 10.0.0.0/24 a uloží objekt do proměnné $IPAddressPool.

Druhý příkaz získá všechny nepřiřazené přidělené objekty IP adres pro fond statických IP adres uložených v $IPAddressPool a uloží objekty do proměnné $IPAddress.

Poslední příkaz odvolá první IP adresu uloženou v $IPAddress a vrátí adresu do fondu IP adres.

Parametry

-AllocatedIPAddress

Určuje IP adresu přidělenou z fondu IP adres.

Typ:AllocatedIPAddress
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Force

Vynutí vrácení přidělené veřejné IP adresy do fondu statických IP adres, pokud síťový adaptér už není online nebo přístupný.

Tento parametr by se měl používat jenom ve spravovaném prostředí síťového adaptéru.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-JobVariable

Určuje, že průběh úlohy je sledován a uložen v proměnné pojmenované tímto parametrem.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnBehalfOfUser

Určuje uživatelské jméno. Tato rutina funguje jménem uživatele, který tento parametr určuje.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnBehalfOfUserRole

Určuje roli uživatele. Pokud chcete získat roli uživatele, použijte rutinu Get-SCUserRole. Tato rutina funguje jménem role uživatele, kterou tento parametr určuje.

Typ:UserRole
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ReturnToPool

Určuje, jestli se IP adresa nebo adresa MAC vrátí do fondu adres. Ve výchozím nastavení je tato hodnota nastavená na $True.

Typ:Boolean
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RunAsynchronously

Označuje, že úloha běží asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VMMServer

Určuje objekt serveru VMM.

Typ:ServerConnection
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Výstupy

CloudDRPairingInfoData

Tato rutina vrátí objekt CloudDRPairingInfoData.