Freigeben über

Remove-SCPXEServer

Modul:
VirtualMachineManager Module

Entfernt ein PXEServer-Objekt aus der VMM-Datenbank.

Syntax

Default (Standardwert) 

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 VMM-Datenbank (Virtual Machine Manager) und deinstalliert den VMM-Agent vom Windows-Bereitstellungsdienstecomputer. 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

Im ersten Befehl werden Sie mit dem Cmdlet Get-Credential aufgefordert, einen Benutzernamen und ein Kennwort einzugeben, und die angegebenen Anmeldeinformationen werden in der Variablen $Credential gespeichert. 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 Variablen $PXEServer.

Mit dem dritten Befehl wird das in $PXEServer gespeicherte PXE-Serverobjekt entfernt. Während der Verarbeitung dieses Befehls stellt $Credential Anmeldeinformationen für Remove-SCPXEServer bereit, und der Parameter Confirm fordert Sie auf, zu bestätigen, dass Sie diesen PXE-Server aus VMM entfernen möchten.

Parameter

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Credential

Gibt ein Objekt mit Anmeldeinformationen oder bei einigen Cmdlets ein ausführendes 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 Fall von Restart-SCJob, verfügt über die Berechtigung zum Abschließen einer neu gestarteten Aufgabe.

Geben Sie weitere Informationen zum PSCredential-Objekt ein Get-Help Get-Credential. Weitere Informationen zu ausführenden Konten erhalten Sie, wenn Sie Get-Help New-SCRunAsAccounteingeben.

Parametereigenschaften

Typ:VMMCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Force

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-JobVariable

Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt wird.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PXEServer

Gibt ein PXE-Serverobjekt an.

Parametereigenschaften

Typ:PxeServer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Parametereigenschaften

Typ:ServerConnection
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.