Dela via


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 GroupIDdet 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.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_BoundaryGroup

ANTECKNINGAR

Get-CMBoundaryGroup

New-CMBoundaryGroup

Remove-CMBoundaryGroup

Set-CMSecurityScope

New-CMBoundary

Definiera platsgränser och gränsgrupper