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

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

-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

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

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

-InputObject

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

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

-NewName

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

Type:String
Aliases:DisplayName, Name
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NewType

Geben Sie den Begrenzungstyp an.

Type:BoundaryTypes
Aliases:NewBoundaryType
Accepted values:IPSubnet, ADSite, IPV6Prefix, IPRange, Vpn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NewValue

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-Type

Geben Sie einen Begrenzungstyp an.

Type:BoundaryTypes
Aliases:BoundaryType
Accepted values:IPSubnet, ADSite, IPV6Prefix, IPRange, Vpn
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Value

Geben Sie die Daten an, die die Grenze beschreiben.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

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

-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

Ausgaben

IResultObject

Hinweise

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