Freigeben über

Remove-SCPXEServer

  • Referenz
Modul:
VirtualMachineManager

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

Mit dem Cmdlet Remove-SCPXEServer-Cmdlet wird ein PXEServer--Objekt aus der VMM-Datenbank (Virtual Machine Manager) entfernt und der VMM-Agent vom Computer der Windows-Bereitstellungsdienste deinstalliert. Mit diesem Cmdlet wird die Windows-Bereitstellungsdiensterolle nicht vom Computer entfernt.

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 variablen $Credential zu speichern. Das Konto muss über lokale Administratorberechtigungen auf dem PXE-Server verfügen.

Der zweite Befehl gbets das PXE-Serverobjekt mit dem Namen WDSServer01 und speichert das Objekt in der $PXEServer Variablen.

Mit dem dritten Befehl wird das PXE-Serverobjekt entfernt, das in $PXEServer gespeichert ist. Wenn dieser Befehl verarbeitet wird, stellt $Credential Anmeldeinformationen für Remove-SCPXEServer-bereit, und die Bestätigen, dass Sie Parameter aufgefordert werden, diesen PXE-Server aus VMM zu entfernen.

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Gibt ein Anmeldeinformationsobjekt 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 hat im Falle von Restart-SCJob-die Berechtigung, eine neu gestartete Aufgabe abzuschließen.

Wenn Sie weitere Informationen zum PSCredential--Objekt erhalten möchten, geben Sie Get-Help Get-Credentialein. Wenn Sie weitere Informationen zu "Als Konten ausführen" wünschen, geben Sie Get-Help New-SCRunAsAccountein.

Typ:VMMCredential
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

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

-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

-PXEServer

Gibt ein PXE-Serverobjekt an.

Typ:PxeServer
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
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

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False