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.