Set-CMBoundaryGroup
SYNOPSIS
Ändra egenskaperna för en gränsgrupp.
SYNTAX
SetByValueMandatory (standard)
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
Cmdleten Set-CMBoundaryGroup ändrar egenskaperna för en gränsgrupp. En gränsgrupp är en samling gränser. Mer information finns i Definiera platsgränser och gränsgrupper och cmdleten New-CMBoundary.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\>
. Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Byt namn på en gränsgrupp
Det här kommandot byter namn på en gränsgrupp. Den använder Get-CMBoundaryGroup cmdlet för att hämta gränsgruppobjektet och skickar det sedan med hjälp av pipelineoperatorn.
Get-CMBoundaryGroup -Name "BGroup01" | Set-CMBoundaryGroup -NewName "BGroup00"
Exempel 2: Lägga till en säkerhetsomfattning i en gränsgrupp
Det här kommandot lägger till säkerhetsomfattningen OSDeploymentScope till gränsgruppen BGroup02.
Set-CMBoundaryGroup -SecurityScopeAction AddMembership -SecurityScopeName "OSDeploymentScope" -Name "BGroup02"
Exempel 3: Lägga till en platssystemserver
Det här kommandot använder cmdleten Get-CMSiteSystemServer för att hämta ett serverobjekt och lägger sedan till det i gränsgruppen.
$server = Get-CMSiteSystemServer -Name "granitefalls.cloudapp.net"
Set-CMBoundaryGroup -Name "Remote BG" -AddSiteSystemServer $server
PARAMETERS
-AddSiteSystemServer
Ange ett platssystemserverobjekt som ska läggas till i gränsgruppen. Klienter i gränsgruppen använder dessa servrar för princip och innehåll. Du kan lägga till hanteringsplatser, distributionsplatser, tillståndsmigreringsplatser, programuppdateringsplatser och molnhanteringsgatewayer. Om du vill hämta ett platssystemserverobjekt använder du cmdleten Get-CMSiteSystemServer.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddSiteSystemServers
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AddSiteSystemServerName
Ange det fullständiga domännamnet för en platssystemserver som ska läggas till i gränsgruppen. Klienter i gränsgruppen använder dessa servrar för princip och innehåll. Du kan lägga till hanteringsplatser, distributionsplatser, tillståndsmigreringsplatser, programuppdateringsplatser och molnhanteringsgatewayer.
Viktigt
Den här parametern kräver platsserverns fullständiga domännamn.
Type: String[]
Parameter Sets: (All)
Aliases: AddSiteSystemServerNames
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowPeerDownload
Konfigurera gränsgruppsalternativet för att tillåta peer-nedladdningar i gränsgruppen. Mer information finns i Gränsgruppsalternativ för peer-nedladdningar.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ClearSiteSystemServer
Lägg till den här parametern för att ta bort alla refererade platssystemservrar från gränsgruppen.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: ClearSiteSystemServers
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DefaultSiteCode
Ange den platskod som ska anges som tilldelad plats och aktivera gränsgruppen för platstilldelning.
Om du vill inaktivera platstilldelning för gränsgruppen anger du det här värdet till $null
.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Beskrivning
Ange en valfri beskrivning för gränsgruppen.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id
Ange ID för en gränsgrupp som ska konfigureras. Detta ID är egenskapen GroupID på det SMS_BoundaryGroup objektet. Till exempel 33
.
Type: String
Parameter Sets: SetById
Aliases: GroupId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Ange ett objekt för en gränsgrupp som ska konfigureras. Om du vill hämta ett gränsgruppobjekt använder du cmdleten Get-CMBoundaryGroup.
Type: IResultObject
Parameter Sets: SetByValueMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Ange namnet på en gränsgrupp som ska konfigureras.
Type: String
Parameter Sets: SetByName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewName
Använd den här parametern för att byta namn på en gränsgrupp.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar denna cmdlet kanske inte några utdata.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PreferCloudDPOverDP
Konfigurera gränsgruppsalternativet för att föredra molnbaserade källor framför lokala källor. Mer information finns i Gränsgruppsalternativ för peer-nedladdningar.
Type: Boolean
Parameter Sets: (All)
Aliases: PreferCloudDistributionPointOverDistributionPoint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PreferDPOverPeer
Konfigurera gränsgruppsalternativet så att distributionsplatser prioriteras framför peer-platser inom samma undernät. Om du vill aktivera den här inställningen aktiverar du även -AllowPeerDownload. Mer information finns i Gränsgruppsalternativ för peer-nedladdningar.
Type: Boolean
Parameter Sets: (All)
Aliases: PreferDistributionPointOverPeerInSubnet
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveSiteSystemServer
Anger ett platssystemserverobjekt som ska tas bort från gränsgruppen. Hämta det här objektet med hjälp av cmdleten Get-CMSiteSystemServer.
Om du vill ta bort alla platssystemservrar använder du parametern -ClearSiteSystemServer.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: RemoveSiteSystemServers
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveSiteSystemServerName
Anger namnet på en eller flera platssystemservrar som ska tas bort från gränsgruppen. Om du vill ta bort alla platssystemservrar använder du parametern -ClearSiteSystemServer.
Type: String[]
Parameter Sets: (All)
Aliases: RemoveSiteSystemServerNames
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SubnetPeerDownloadOnly
Konfigurera gränsgruppalternativet för att endast använda peer-peers i samma undernät under peer-hämtningar. Om du vill aktivera den här inställningen aktiverar du även -AllowPeerDownload. Mer information finns i Gränsgruppsalternativ för peer-nedladdningar.
Type: Boolean
Parameter Sets: (All)
Aliases: PeerWithinSameSubnetOnly
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.