Freigeben über

Set-CMBoundaryGroup

  • Referenz
Modul:
ConfigurationManager

Ändern sie die Eigenschaften einer Begrenzungsgruppe.

Syntax

Set-CMBoundaryGroup
   [-AddSiteSystemServer <IResultObject[]>]
   [-AddSiteSystemServerName <String[]>]
   [-AllowPeerDownload <Boolean>]
   [-ClearSiteSystemServer]
   [-DefaultSiteCode <String>]
   [-Description <String>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-PreferCloudDPOverDP <Boolean>]
   [-PreferDPOverPeer <Boolean>]
   [-RemoveSiteSystemServer <IResultObject[]>]
   [-RemoveSiteSystemServerName <String[]>]
   [-SubnetPeerDownloadOnly <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMBoundaryGroup
   [-AddSiteSystemServer <IResultObject[]>]
   [-AddSiteSystemServerName <String[]>]
   [-AllowPeerDownload <Boolean>]
   [-ClearSiteSystemServer]
   [-DefaultSiteCode <String>]
   [-Description <String>]
   -Id <String>
   [-NewName <String>]
   [-PassThru]
   [-PreferCloudDPOverDP <Boolean>]
   [-PreferDPOverPeer <Boolean>]
   [-RemoveSiteSystemServer <IResultObject[]>]
   [-RemoveSiteSystemServerName <String[]>]
   [-SubnetPeerDownloadOnly <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMBoundaryGroup
   [-AddSiteSystemServer <IResultObject[]>]
   [-AddSiteSystemServerName <String[]>]
   [-AllowPeerDownload <Boolean>]
   [-ClearSiteSystemServer]
   [-DefaultSiteCode <String>]
   [-Description <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-PreferCloudDPOverDP <Boolean>]
   [-PreferDPOverPeer <Boolean>]
   [-RemoveSiteSystemServer <IResultObject[]>]
   [-RemoveSiteSystemServerName <String[]>]
   [-SubnetPeerDownloadOnly <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-CMBoundaryGroup ändert die Eigenschaften einer Begrenzungsgruppe. Eine Begrenzungsgruppe ist eine Sammlung von Grenzen. Weitere Informationen finden Sie unter Definieren von Standortgrenzen und Begrenzungsgruppen und dem Cmdlet New-CMBoundary .

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 Begrenzungsgruppe

Dieser Befehl benennt eine Begrenzungsgruppe um. Es verwendet das Cmdlet Get-CMBoundaryGroup, um das Begrenzungsgruppenobjekt abzurufen, und übergibt es dann mithilfe des Pipelineoperators.

Get-CMBoundaryGroup -Name "BGroup01" | Set-CMBoundaryGroup -NewName "BGroup00"

Beispiel 2: Hinzufügen eines Sicherheitsbereichs zu einer Begrenzungsgruppe

Mit diesem Befehl wird der Sicherheitsbereich OSDeploymentScope der Begrenzungsgruppe BGroup02 hinzugefügt.

Set-CMBoundaryGroup -SecurityScopeAction AddMembership -SecurityScopeName "OSDeploymentScope" -Name "BGroup02"

Beispiel 3: Hinzufügen eines Standortsystemservers

Dieser Befehl verwendet das Cmdlet Get-CMSiteSystemServer , um ein Serverobjekt abzurufen, und fügt es dann der Begrenzungsgruppe hinzu.

$server = Get-CMSiteSystemServer -Name "granitefalls.cloudapp.net"
Set-CMBoundaryGroup -Name "Remote BG" -AddSiteSystemServer $server

Parameter

-AddSiteSystemServer

Geben Sie ein Standortsystemserverobjekt an, das dieser Begrenzungsgruppe hinzugefügt werden soll. Clients in der Begrenzungsgruppe verwenden diese Server für Richtlinien und Inhalte. Sie können Verwaltungspunkte, Verteilungspunkte, Zustandsmigrationspunkte, Softwareupdatepunkte und Cloudverwaltungsgateways hinzufügen. Verwenden Sie zum Abrufen eines Standortsystemserverobjekts das Cmdlet Get-CMSiteSystemServer .

Typ:IResultObject[]
Aliase:AddSiteSystemServers
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AddSiteSystemServerName

Geben Sie den vollqualifizierten Domänennamen eines Standortsystemservers an, der dieser Begrenzungsgruppe hinzugefügt werden soll. Clients in der Begrenzungsgruppe verwenden diese Server für Richtlinien und Inhalte. Sie können Verwaltungspunkte, Verteilungspunkte, Zustandsmigrationspunkte, Softwareupdatepunkte und Cloudverwaltungsgateways hinzufügen.

Wichtig

Dieser Parameter erfordert den vollqualifizierten Domänennamen des Standortservers.

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

-AllowPeerDownload

Konfigurieren Sie die Begrenzungsgruppenoption, um Peerdownloads in dieser Begrenzungsgruppe zuzulassen. Weitere Informationen finden Sie unter Begrenzungsgruppenoptionen für Peerdownloads.

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

-ClearSiteSystemServer

Fügen Sie diesen Parameter hinzu, um alle referenzierten Standortsystemserver aus der Begrenzungsgruppe zu entfernen.

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

-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

-DefaultSiteCode

Geben Sie den Standortcode an, der als zugewiesener Standort festgelegt werden soll, und aktivieren Sie die Begrenzungsgruppe für die Standortzuweisung.

Um die Standortzuweisung für die Begrenzungsgruppe zu deaktivieren, legen Sie diesen Wert auf fest $null.

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

-Description

Geben Sie eine optionale Beschreibung für diese Begrenzungsgruppe an.

Typ:String
Position:Named
Standardwert:None
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 die ID einer zu konfigurierenden Begrenzungsgruppe an. Diese ID ist die GroupID-Eigenschaft für das SMS_BoundaryGroup-Objekt . Beispiel: 33.

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

-InputObject

Geben Sie ein Objekt für eine zu konfigurierende Begrenzungsgruppe an. Verwenden Sie das Cmdlet Get-CMBoundaryGroup , um ein Begrenzungsgruppenobjekt abzurufen.

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

-Name

Geben Sie den Namen für eine zu konfigurierende Begrenzungsgruppe an.

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

-NewName

Verwenden Sie diesen Parameter, um eine Begrenzungsgruppe umzubenennen.

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

-PassThru

Gibt ein Objekt zurück, 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

-PreferCloudDPOverDP

Konfigurieren Sie die Begrenzungsgruppenoption so, dass cloudbasierte Quellen gegenüber lokalen Quellen bevorzugt werden. Weitere Informationen finden Sie unter Begrenzungsgruppenoptionen für Peerdownloads.

Typ:Boolean
Aliase:PreferCloudDistributionPointOverDistributionPoint
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PreferDPOverPeer

Konfigurieren Sie die Begrenzungsgruppenoption so, dass Verteilungspunkte gegenüber Peers innerhalb desselben Subnetzes bevorzugt werden. Um diese Einstellung zu aktivieren, aktivieren Sie auch -AllowPeerDownload. Weitere Informationen finden Sie unter Begrenzungsgruppenoptionen für Peerdownloads.

Typ:Boolean
Aliase:PreferDistributionPointOverPeerInSubnet
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RemoveSiteSystemServer

Gibt ein Standortsystemserverobjekt an, das aus der Begrenzungsgruppe entfernt werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMSiteSystemServer .

Um alle Standortsystemserver zu entfernen, verwenden Sie den Parameter -ClearSiteSystemServer .

Typ:IResultObject[]
Aliase:RemoveSiteSystemServers
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RemoveSiteSystemServerName

Gibt den Namen eines oder mehrerer Standortsystemserver an, die aus der Begrenzungsgruppe entfernt werden sollen. Um alle Standortsystemserver zu entfernen, verwenden Sie den Parameter -ClearSiteSystemServer .

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

-SubnetPeerDownloadOnly

Konfigurieren Sie die Begrenzungsgruppenoption so, dass während Peerdownloads nur Peers innerhalb desselben Subnetzes verwendet werden. Um diese Einstellung zu aktivieren, aktivieren Sie auch -AllowPeerDownload. Weitere Informationen finden Sie unter Begrenzungsgruppenoptionen für Peerdownloads.

Typ:Boolean
Aliase:PeerWithinSameSubnetOnly
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