Set-CMBoundaryGroup
SYNOPSIS
Wijzig de eigenschappen van een grensgroep.
SYNTAX
SetByValueMandatory (standaard)
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>]
SetById
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>]
SetByName
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>]
DESCRIPTION
De cmdlet Set-CMBoundaryGroup wijzigt de eigenschappen van een grensgroep. Een grensgroep is een verzameling grenzen. Zie Sitegrenzen en grensgroepen definiëren en de cmdlet New-CMBoundary voor meer informatie.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: De naam van een grensgroep wijzigen
Met deze opdracht wordt de naam van een grensgroep gewijzigd. De cmdlet Get-CMBoundaryGroup gebruikt om het grensgroepsobject op te halen en vervolgens door te geven met behulp van de pijplijnoperator.
Get-CMBoundaryGroup -Name "BGroup01" | Set-CMBoundaryGroup -NewName "BGroup00"
Voorbeeld 2: Een beveiligingsbereik toevoegen aan een grensgroep
Met deze opdracht wordt het beveiligingsbereik OSDeploymentScope toegevoegd aan de grensgroep BGroup02.
Set-CMBoundaryGroup -SecurityScopeAction AddMembership -SecurityScopeName "OSDeploymentScope" -Name "BGroup02"
Voorbeeld 3: Een sitesysteemserver toevoegen
Deze opdracht maakt gebruik van de cmdlet Get-CMSiteSystemServer om een serverobject op te halen en voegt dit vervolgens toe aan de grensgroep.
$server = Get-CMSiteSystemServer -Name "granitefalls.cloudapp.net"
Set-CMBoundaryGroup -Name "Remote BG" -AddSiteSystemServer $server
PARAMETERS
-AddSiteSystemServer
Geef een sitesysteemserverobject op dat u wilt toevoegen aan deze grensgroep. Clients in de grensgroep gebruiken deze servers voor beleid en inhoud. U kunt beheerpunten, distributiepunten, statusmigratiepunten, software-updatepunten en cloudbeheergateways toevoegen. Gebruik de cmdlet Get-CMSiteSystemServer om een sitesysteemserverobject op te halen.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddSiteSystemServers
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AddSiteSystemServerName
Geef de fully qualified domain name van een sitesysteemserver op die u wilt toevoegen aan deze grensgroep. Clients in de grensgroep gebruiken deze servers voor beleid en inhoud. U kunt beheerpunten, distributiepunten, statusmigratiepunten, software-updatepunten en cloudbeheergateways toevoegen.
Belangrijk
Voor deze parameter is de volledig gekwalificeerde domeinnaam van de siteserver vereist.
Type: String[]
Parameter Sets: (All)
Aliases: AddSiteSystemServerNames
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowPeerDownload
Configureer de optie grensgroep om peerdownloads toe te staan in deze grensgroep. Zie Grensgroepopties voor peerdownloads voor meer informatie.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ClearSiteSystemServer
Voeg deze parameter toe om alle sitesysteemservers waarnaar wordt verwezen uit de grensgroep te verwijderen.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: ClearSiteSystemServers
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DefaultSiteCode
Geef de sitecode op die moet worden ingesteld als de toegewezen site en schakel de grensgroep in voor sitetoewijzing.
Als u sitetoewijzing voor de grensgroep wilt uitschakelen, stelt u deze waarde in op $null .
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Beschrijving
Geef een optionele beschrijving op voor deze grensgroep.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id
Geef de id op van een grensgroep die u wilt configureren. Deze id is de eigenschap GroupID op het SMS_BoundaryGroup object. Bijvoorbeeld 33.
Type: String
Parameter Sets: SetById
Aliases: GroupId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Geef een object op voor een grensgroep die u wilt configureren. Gebruik de cmdlet Get-CMBoundaryGroup om een grensgroepobject op te halen.
Type: IResultObject
Parameter Sets: SetByValueMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Geef de naam op voor een grensgroep die u wilt configureren.
Type: String
Parameter Sets: SetByName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewName
Gebruik deze parameter om de naam van een grensgroep te wijzigen.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Retourneert een -object dat het item vertegenwoordigt waarmee u werkt. Standaard is het mogelijk dat deze cmdlet geen uitvoer genereert.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PreferCloudDPOverDP
Configureer de optie grensgroep om de voorkeur te geven aan cloudbronnen boven on-premises bronnen. Zie Grensgroepopties voor peerdownloads voor meer informatie.
Type: Boolean
Parameter Sets: (All)
Aliases: PreferCloudDistributionPointOverDistributionPoint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PreferDPOverPeer
Configureer de optie grensgroep om de voorkeur te geven aan distributiepunten boven peers binnen hetzelfde subnet. Als u deze instelling wilt inschakelen, moet u ook -AllowPeerDownload inschakelen. Zie Grensgroepopties voor peerdownloads voor meer informatie.
Type: Boolean
Parameter Sets: (All)
Aliases: PreferDistributionPointOverPeerInSubnet
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveSiteSystemServer
Hiermee geeft u een sitesysteemserverobject op dat moet worden verwijderd uit de grensgroep. Gebruik de cmdlet Get-CMSiteSystemServer om dit object op te halen.
Als u alle sitesysteemservers wilt verwijderen, gebruikt u de parameter -ClearSiteSystemServer.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: RemoveSiteSystemServers
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveSiteSystemServerName
Hiermee geeft u de naam op van een of meer sitesysteemservers die moeten worden verwijderd uit de grensgroep. Als u alle sitesysteemservers wilt verwijderen, gebruikt u de parameter -ClearSiteSystemServer.
Type: String[]
Parameter Sets: (All)
Aliases: RemoveSiteSystemServerNames
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SubnetPeerDownloadOnly
Configureer de grensgroepsoptie om alleen peers binnen hetzelfde subnet te gebruiken tijdens peerdownloads. Als u deze instelling wilt inschakelen, moet u ook -AllowPeerDownload inschakelen. Zie Grensgroepopties voor peerdownloads voor meer informatie.
Type: Boolean
Parameter Sets: (All)
Aliases: PeerWithinSameSubnetOnly
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.