Freigeben über


Remove-SCPXEServer

Entfernt ein PXEServer-Objekt aus der VMM-Datenbank.

Syntax

Remove-SCPXEServer
      [-VMMServer <ServerConnection>]
      [-PXEServer] <PxeServer>
      -Credential <VMMCredential>
      [-Force]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-SCPXEServer entfernt ein PXEServer-Objekt aus der Virtual Machine Manager -Datenbank (VMM), und deinstalliert den VMM-Agent auf dem Windows Deployment Services-Computer. Dieses Cmdlet entfernt die Windows-Bereitstellungsdiensterolle nicht vom Computer.

Beispiele

Beispiel 1: Entfernen eines VMM PXE-Servers

PS C:\> $Credential = Get-SCRunAsAccount "RunAsAcct01"
PS C:\> $PXEServer = Get-SCPXEServer -ComputerName "WDSServer01.Contoso.com"
PS C:\> Remove-SCPXEServer -PXEServer $PXEServer -Credential $Credential -Confirm

Der erste Befehl verwendet das Cmdlet "Get-Credential ", um Sie aufzufordern, einen Benutzernamen und ein Kennwort anzugeben und die bereitgestellten Anmeldeinformationen in der $Credential Variablen zu speichern. Das Konto muss über lokale Administratorberechtigungen auf dem PXE-Server verfügen.

Der zweite Befehl gbets das PXE-Serverobjekt namens WDSServer01 und speichert das Objekt in der $PXEServer Variable.

Der dritte Befehl entfernt das IN $PXEServer gespeicherte PXE-Serverobjekt. Da dieser Befehl verarbeitet wird, stellt $Credential Anmeldeinformationen für Remove-SCPXEServer bereit, und der Parameter " Bestätigen ", um zu bestätigen, dass Sie diesen PXE-Server aus VMM entfernen möchten.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-Credential

Gibt ein Anmeldeinformationenobjekt oder für einige Cmdlets ein Run As-Kontoobjekt an, das den Benutzernamen und das Kennwort eines Kontos enthält, das über die Berechtigung zum Ausführen dieser Aktion verfügt. Oder im Falle von Neustart-SCJob hat die Berechtigung zum Abschließen einer neu gestarteten Aufgabe.

Weitere Informationen zum PSCredential-Objekt geben Sie Get-Help Get-Credentialein. Geben Sie Get-Help New-SCRunAsAccountweitere Informationen zu "Ausführen als Konten" ein.

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

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

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

-PROTipID

Gibt die ID der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die 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

-PXEServer

Gibt ein PXE-Serverobjekt an.

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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