Set-CMBoundary

Referenz

Modul:: ConfigurationManager

Konfigurieren sie eine Standortgrenze.

Syntax

Set-CMBoundary
   -InputObject <IResultObject>
   [-NewName <String>]
   [-NewType <BoundaryTypes>]
   [-NewValue <String>]
   [-PassThru]
   [-ValueStartsWith <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMBoundary
   -Id <String>
   [-NewName <String>]
   [-NewType <BoundaryTypes>]
   [-NewValue <String>]
   [-PassThru]
   [-ValueStartsWith <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMBoundary
   [-NewName <String>]
   [-NewType <BoundaryTypes>]
   [-NewValue <String>]
   [-PassThru]
   -Type <BoundaryTypes>
   -Value <String>
   [-ValueStartsWith <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um eine Standortgrenze zu konfigurieren. Eine Grenze ist ein Netzwerkspeicherort, der ein oder mehrere Geräte enthält, die Sie verwalten können. Eine Grenze kann ein IP-Subnetz, ein Active Directory-Standortname, ein IPv6-Präfix, ein IP-Adressbereich oder ein VPN sein. Weitere Informationen finden Sie unter Definieren von Standortgrenzen und Begrenzungsgruppen.

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: Umbenennen einer Grenze

Dieser Befehl ändert einen Begrenzungsnamen von Default-ADSite in ADSiteBoundary01.

Set-CMBoundary -Name "Default-ADSite" -NewName "ADSiteBoundary01"

Beispiel 2: Ändern des Werts einer Grenze mithilfe eines InputObject

In diesem Beispiel ruft der erste Befehl eine Grenze ab, die die ID von 16777217 aufweist, und fügt sie in das Eingabeobjekt $BoundaryObj ein.

Der zweite Befehl identifiziert die Grenze mithilfe des Eingabeobjekts $BoundaryObj und ändert seinen Wert in IPSubnet17.

$BoundaryObj = Get-CMBoundary -Id "16777217"
Set-CMBoundary -InputObject $BoundaryObj -Value "IPSubnet17"

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

-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

Geben Sie einen zu ändernden Begrenzungsbezeichner (ID) an. Dieser Wert ist eine ganze Zahl, z. B 26. .

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

-InputObject

Geben Sie ein zu ändernde Begrenzungsobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMBoundary .

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

-NewName

Geben Sie einen neuen Namen für eine Grenze an.

Typ:	String
Aliase:	DisplayName, Name
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-NewType

Geben Sie den Begrenzungstyp an.

Typ:	BoundaryTypes
Aliase:	NewBoundaryType
Zulässige Werte:	IPSubnet, ADSite, IPV6Prefix, IPRange, Vpn
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-NewValue

Geben Sie die Daten an, die die Grenze definieren. Ein Active Directory-Standortwert kann beispielsweise sein Default-First-Site-Name.

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

-PassThru

Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

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

-Type

Geben Sie einen Begrenzungstyp an.

Typ:	BoundaryTypes
Aliase:	BoundaryType
Zulässige Werte:	IPSubnet, ADSite, IPV6Prefix, IPRange, Vpn
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Value

Geben Sie die Daten an, die die Grenze beschreiben.

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

-ValueStartsWith

Legen Sie diesen Parameter auf fest $true , um den Anfang eines Verbindungsnamens oder einer Beschreibung anstelle der gesamten Zeichenfolge abzugleichen. Weitere Informationen finden Sie unter Definieren von Netzwerkstandorten als Grenzen.

Typ:	Boolean
Position:	Named
Standardwert:	None
Erforderlich:	False
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

Ausgaben

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_Boundary WMI-Serverklasse.

Feedback

War diese Seite hilfreich?