Partager via

Set-CMBoundaryGroup

  • Référence
Module:
ConfigurationManager

Modifiez les propriétés d’un groupe de limites.

Syntaxe

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

Description

L’applet de commande Set-CMBoundaryGroup modifie les propriétés d’un groupe de limites. Un groupe de limites est une collection de limites. Pour plus d’informations, consultez Définir des limites de site et des groupes de limites et l’applet de commande New-CMBoundary .

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Renommer un groupe de limites

Cette commande renomme un groupe de limites. Il utilise l’applet de commande Get-CMBoundaryGroup pour obtenir l’objet de groupe de limites, puis le transmet à l’aide de l’opérateur de pipeline.

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

Exemple 2 : Ajouter une étendue de sécurité à un groupe de limites

Cette commande ajoute l’étendue de sécurité OSDeploymentScope au groupe de limites BGroup02.

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

Exemple 3 : Ajouter un serveur de système de site

Cette commande utilise l’applet de commande Get-CMSiteSystemServer pour obtenir un objet serveur, puis l’ajoute au groupe de limites.

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

Paramètres

-AddSiteSystemServer

Spécifiez un objet serveur de système de site à ajouter à ce groupe de limites. Les clients du groupe de limites utilisent ces serveurs pour la stratégie et le contenu. Vous pouvez ajouter des points de gestion, des points de distribution, des points de migration d’état, des points de mise à jour logicielle et des passerelles de gestion cloud. Pour obtenir un objet serveur de système de site, utilisez l’applet de commande Get-CMSiteSystemServer .

Type:IResultObject[]
Alias:AddSiteSystemServers
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AddSiteSystemServerName

Spécifiez le nom de domaine complet d’un serveur de système de site à ajouter à ce groupe de limites. Les clients du groupe de limites utilisent ces serveurs pour la stratégie et le contenu. Vous pouvez ajouter des points de gestion, des points de distribution, des points de migration d’état, des points de mise à jour logicielle et des passerelles de gestion cloud.

Importante

Ce paramètre nécessite le nom de domaine complet du serveur de site.

Type:String[]
Alias:AddSiteSystemServerNames
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-AllowPeerDownload

Configurez l’option groupe de limites pour autoriser les téléchargements d’homologues dans ce groupe de limites. Pour plus d’informations, consultez Options de groupe de limites pour les téléchargements d’homologues.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ClearSiteSystemServer

Ajoutez ce paramètre pour supprimer tous les serveurs de système de site référencés du groupe de limites.

Type:SwitchParameter
Alias:ClearSiteSystemServers
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultSiteCode

Spécifiez le code de site à définir comme site attribué et activez le groupe de limites pour l’attribution de site.

Pour désactiver l’attribution de site pour le groupe de limites, définissez cette valeur sur $null.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Description

Spécifiez une description facultative pour ce groupe de limites.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Id

Spécifiez l’ID d’un groupe de limites à configurer. Cet ID est la propriété GroupID sur l’objet SMS_BoundaryGroup . Par exemple : 33.

Type:String
Alias:GroupId
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifiez un objet pour un groupe de limites à configurer. Pour obtenir un objet de groupe de limites, utilisez l’applet de commande Get-CMBoundaryGroup .

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifiez le nom d’un groupe de limites à configurer.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NewName

Utilisez ce paramètre pour renommer un groupe de limites.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PassThru

Renvoie un objet représentant l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PreferCloudDPOverDP

Configurez l’option de groupe de limites pour préférer les sources cloud aux sources locales. Pour plus d’informations, consultez Options de groupe de limites pour les téléchargements d’homologues.

Type:Boolean
Alias:PreferCloudDistributionPointOverDistributionPoint
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PreferDPOverPeer

Configurez l’option de groupe de limites pour préférer les points de distribution aux homologues du même sous-réseau. Pour activer ce paramètre, activez également -AllowPeerDownload. Pour plus d’informations, consultez Options de groupe de limites pour les téléchargements d’homologues.

Type:Boolean
Alias:PreferDistributionPointOverPeerInSubnet
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RemoveSiteSystemServer

Spécifie un objet serveur de système de site à supprimer du groupe de limites. Pour obtenir cet objet, utilisez l’applet de commande Get-CMSiteSystemServer .

Pour supprimer tous les serveurs de système de site, utilisez le paramètre -ClearSiteSystemServer .

Type:IResultObject[]
Alias:RemoveSiteSystemServers
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RemoveSiteSystemServerName

Spécifie le nom d’un ou plusieurs serveurs de système de site à supprimer du groupe de limites. Pour supprimer tous les serveurs de système de site, utilisez le paramètre -ClearSiteSystemServer .

Type:String[]
Alias:RemoveSiteSystemServerNames
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SubnetPeerDownloadOnly

Configurez l’option de groupe de limites pour utiliser uniquement des homologues au sein du même sous-réseau pendant les téléchargements d’homologues. Pour activer ce paramètre, activez également -AllowPeerDownload. Pour plus d’informations, consultez Options de groupe de limites pour les téléchargements d’homologues.

Type:Boolean
Alias:PeerWithinSameSubnetOnly
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject