Freigeben über

Remove-CMBoundaryGroup

  • Referenz
Modul:
ConfigurationManager

Entfernt eine Begrenzungsgruppe.

Syntax

Remove-CMBoundaryGroup
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMBoundaryGroup
      [-Force]
      -Id <String[]>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMBoundaryGroup
      [-Force]
      -Name <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-CMBoundaryGroup entfernt eine Begrenzungsgruppe aus Configuration Manager.

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 einer Begrenzungsgruppe, die durch ihre ID angegeben wird

PS XYZ:\> Remove-CMBoundaryGroup -Id "16777219"

Dieser Befehl entfernt eine Begrenzungsgruppe, die durch ihren Bezeichner angegeben wird. Da der Force-Parameter nicht angegeben ist, müssen Sie die Aktion bestätigen, bevor sie ausgeführt wird.

Beispiel 2: Entfernen mehrerer Begrenzungsgruppen mithilfe eines InputObject

PS XYZ:\> $BoundaryObj = Get-CMBoundary -Name "BGroup01", "BGroup02", "BGroup03"
PS XYZ:\> Remove-CMBoundary -InputObject $BoundaryObj

Der erste Befehl verwendet Get-CMBoundaryGroup , um mehrere Begrenzungsgruppen abzurufen, die durch ihre Namen angegeben sind, und speichert diese Daten in der $BoundaryObj Variablen.

Der zweite Befehl identifiziert und entfernt die Grenzen, die mithilfe des Eingabeobjekts $BoundaryObj angegeben werden. Da der Force-Parameter nicht angegeben ist, müssen Sie die Aktion bestätigen, bevor sie ausgeführt 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

-Id

Gibt ein Array von Bezeichnern (IDs) für eine oder mehrere Begrenzungsgruppen an.

Typ:String[]
Aliase:GroupId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt ein Eingabeobjekt für dieses Cmdlet an. Sie können das Eingabeobjekt mithilfe des Cmdlets Get-CMBoundaryGroup abrufen.

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

-Name

Gibt den Namen einer Begrenzungsgruppe an.

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

-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