Condividi tramite

Set-CMBoundaryGroup

  • Riferimento
Modulo:
ConfigurationManager

Modificare le proprietà di un gruppo di limiti.

Sintassi

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>]

Descrizione

Il cmdlet Set-CMBoundaryGroup modifica le proprietà di un gruppo di limiti. Un gruppo di limiti è una raccolta di limiti. Per altre informazioni, vedere Definire limiti e gruppi di limiti del sito e il cmdlet New-CMBoundary .

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Rinominare un gruppo di limiti

Questo comando rinomina un gruppo di limiti. Usa il cmdlet Get-CMBoundaryGroup per ottenere l'oggetto gruppo di limiti e quindi lo passa usando l'operatore della pipeline.

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

Esempio 2: Aggiungere un ambito di sicurezza a un gruppo di limiti

Questo comando aggiunge l'ambito di sicurezza OSDeploymentScope al gruppo di limiti BGroup02.

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

Esempio 3: Aggiungere un server del sistema del sito

Questo comando usa il cmdlet Get-CMSiteSystemServer per ottenere un oggetto server e quindi lo aggiunge al gruppo di limiti.

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

Parametri

-AddSiteSystemServer

Specificare un oggetto server del sistema del sito da aggiungere a questo gruppo di limiti. I client nel gruppo di limiti usano questi server per i criteri e il contenuto. È possibile aggiungere punti di gestione, punti di distribuzione, punti di migrazione dello stato, punti di aggiornamento software e gateway di gestione cloud. Per ottenere un oggetto server del sistema del sito, usare il cmdlet Get-CMSiteSystemServer .

Tipo:IResultObject[]
Alias:AddSiteSystemServers
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AddSiteSystemServerName

Specificare il nome di dominio completo di un server del sistema del sito da aggiungere a questo gruppo di limiti. I client nel gruppo di limiti usano questi server per i criteri e il contenuto. È possibile aggiungere punti di gestione, punti di distribuzione, punti di migrazione dello stato, punti di aggiornamento software e gateway di gestione cloud.

Importante

Questo parametro richiede il nome di dominio completo del server del sito.

Tipo:String[]
Alias:AddSiteSystemServerNames
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AllowPeerDownload

Configurare l'opzione del gruppo di limiti per consentire i download peer in questo gruppo di limiti. Per altre informazioni, vedere Opzioni del gruppo di limiti per i download peer.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ClearSiteSystemServer

Aggiungere questo parametro per rimuovere tutti i server del sistema del sito a cui si fa riferimento dal gruppo di limiti.

Tipo:SwitchParameter
Alias:ClearSiteSystemServers
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultSiteCode

Specificare il codice del sito da impostare come sito assegnato e abilitare il gruppo di limiti per l'assegnazione del sito.

Per disabilitare l'assegnazione del sito per il gruppo di limiti, impostare questo valore su $null.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specificare una descrizione facoltativa per questo gruppo di limiti.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specificare l'ID di un gruppo di limiti da configurare. Questo ID è la proprietà GroupID nell'oggetto SMS_BoundaryGroup . Ad esempio, 33.

Tipo:String
Alias:GroupId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specificare un oggetto per un gruppo di limiti da configurare. Per ottenere un oggetto gruppo di limiti, usare il cmdlet Get-CMBoundaryGroup .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specificare il nome di un gruppo di limiti da configurare.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NewName

Usare questo parametro per rinominare un gruppo di limiti.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Restituisce un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PreferCloudDPOverDP

Configurare l'opzione del gruppo di limiti per preferire le origini basate sul cloud rispetto alle origini locali. Per altre informazioni, vedere Opzioni del gruppo di limiti per i download peer.

Tipo:Boolean
Alias:PreferCloudDistributionPointOverDistributionPoint
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PreferDPOverPeer

Configurare l'opzione del gruppo di limiti per preferire i punti di distribuzione rispetto ai peer all'interno della stessa subnet. Per abilitare questa impostazione, abilitare anche -AllowPeerDownload. Per altre informazioni, vedere Opzioni del gruppo di limiti per i download peer.

Tipo:Boolean
Alias:PreferDistributionPointOverPeerInSubnet
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveSiteSystemServer

Specifica un oggetto server del sistema del sito da rimuovere dal gruppo di limiti. Per ottenere questo oggetto, usare il cmdlet Get-CMSiteSystemServer .

Per rimuovere tutti i server del sistema del sito, usare il parametro -ClearSiteSystemServer .

Tipo:IResultObject[]
Alias:RemoveSiteSystemServers
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveSiteSystemServerName

Specifica il nome di uno o più server del sistema del sito da rimuovere dal gruppo di limiti. Per rimuovere tutti i server del sistema del sito, usare il parametro -ClearSiteSystemServer .

Tipo:String[]
Alias:RemoveSiteSystemServerNames
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SubnetPeerDownloadOnly

Configurare l'opzione del gruppo di limiti per usare solo peer all'interno della stessa subnet durante i download peer. Per abilitare questa impostazione, abilitare anche -AllowPeerDownload. Per altre informazioni, vedere Opzioni del gruppo di limiti per i download peer.

Tipo:Boolean
Alias:PeerWithinSameSubnetOnly
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

IResultObject