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-Websitelaufwerk aus, z. PS XYZ:\>B. . 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.

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

-DisableWildcardHandling

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

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

-Force

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

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

-ForceWildcardHandling

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

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

-Id

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

Type:String[]
Aliases:GroupId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

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

-Name

Gibt den Namen einer Begrenzungsgruppe an.

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

-WhatIf

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject