Freigeben über

Remove-CMDistributionPoint

  • Referenz
Modul:
ConfigurationManager

Entfernt einen Verteilungspunkt.

Syntax

Remove-CMDistributionPoint
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDistributionPoint
      [-Force]
      [-SiteCode <String>]
      [-SiteSystemServerName] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-CMDistributionPoint entfernt einen Verteilungspunkt. Wenn Sie einen Verteilungspunkt entfernen, entfernen Sie die Bezeichnung eines Standortsystemservers als Verteilungszentrum für Inhaltsdateien für Anwendungen, Pakete, Softwareupdates und Betriebssystembereitstellungen.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Entfernen eines Verteilungspunkts mithilfe der Pipeline

PS XYZ:\> Get-CMDistributionPoint -SiteSystemServerName "MySiteSys_11310.Contoso.com" | Remove-CMDistributionPoint -Force

Dieser Befehl ruft das Verteilungspunktobjekt für den Standortsystemserver mit dem Namen MySiteSys_11310.Contoso.com ab und verwendet den Pipelineoperator, um das Objekt an Remove-CMDistributionPoint zu übergeben, wodurch das Verteilungspunktobjekt entfernt wird. Die Angabe des Force-Parameters gibt an, dass der Benutzer nicht aufgefordert wird, bevor der Verteilungspunkt entfernt wird.

Beispiel 2: Entfernen eines Verteilungspunkts mithilfe einer Objektvariablen

PS XYZ:\> $DP = Get-CMDistributionPoint -SiteSystemServerName "MySiteSys_11310.Contoso.com"
PS XYZ:\> Remove-CMDistributionPoint -InputObject $DP -Force

Der erste Befehl ruft das Verteilungspunktobjekt für den Standortsystemserver mit dem Namen MySiteSys_11310.Contoso.com ab und speichert das Objekt in der variablen $DP.

Der zweite Befehl entfernt den in $DP gespeicherten Verteilungspunkt. Die Angabe des Force-Parameters gibt an, dass der Benutzer nicht aufgefordert wird, bevor der Verteilungspunkt entfernt wird.

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

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Erzwingt die Ausführung des Befehls ohne Benutzerbestätigung.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt ein Verteilungspunktobjekt an. Verwenden Sie zum Abrufen eines Verteilungspunktobjekts das Cmdlet Get-CMDistributionPoint .

Typ:IResultObject
Aliase:DistributionPoint
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SiteCode

Gibt den Standortcode für den Configuration Manager-Standort an, der diese Standortsystemrolle hostet.

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

-SiteSystemServerName

Gibt den FQDN des Servers an, der die Standortsystemrolle hostet.

Typ:String
Aliase:Name, ServerName
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, 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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject