Set-CMBoundaryGroup

  • Referência
Módulo:
ConfigurationManager

Modifique as propriedades de um grupo de limites.

Sintaxe

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

O cmdlet Set-CMBoundaryGroup modifica as propriedades de um grupo de limites. Um grupo de limites é uma coleção de limites. Para obter mais informações, veja Definir limites de site e grupos de limites e o cmdlet New-CMBoundary .

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Mudar o nome de um grupo de limites

Este comando muda o nome de um grupo de limites. Utiliza o cmdlet Get-CMBoundaryGroup para obter o objeto do grupo de limites e, em seguida, transmite-o com o operador de pipeline.

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

Exemplo 2: adicionar um âmbito de segurança a um grupo de limites

Este comando adiciona o âmbito de segurança OSDeploymentScope ao grupo de limites BGroup02.

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

Exemplo 3: Adicionar um servidor do sistema de sites

Este comando utiliza o cmdlet Get-CMSiteSystemServer para obter um objeto de servidor e, em seguida, adiciona-o ao grupo de limites.

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

Parâmetros

-AddSiteSystemServer

Especifique um objeto de servidor do sistema de sites para adicionar a este grupo de limites. Os clientes no grupo de limites utilizam estes servidores para política e conteúdo. Pode adicionar pontos de gestão, pontos de distribuição, pontos de migração de estado, pontos de atualização de software e gateways de gestão da cloud. Para obter um objeto de servidor do sistema de sites, utilize o cmdlet Get-CMSiteSystemServer .

Tipo:IResultObject[]
Aliases:AddSiteSystemServers
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AddSiteSystemServerName

Especifique o nome de domínio completamente qualificado de um servidor do sistema de sites para adicionar a este grupo de limites. Os clientes no grupo de limites utilizam estes servidores para política e conteúdo. Pode adicionar pontos de gestão, pontos de distribuição, pontos de migração de estado, pontos de atualização de software e gateways de gestão da cloud.

Importante

Este parâmetro requer o nome de domínio completamente qualificado do servidor do site.

Tipo:String[]
Aliases:AddSiteSystemServerNames
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AllowPeerDownload

Configure a opção de grupo de limites para permitir transferências do elemento da rede neste grupo de limites. Para obter mais informações, veja Opções de grupo de limites para transferências de elementos da rede.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClearSiteSystemServer

Adicione este parâmetro para remover todos os servidores do sistema de sites referenciados do grupo de limites.

Tipo:SwitchParameter
Aliases:ClearSiteSystemServers
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultSiteCode

Especifique o código do site a definir como o site atribuído e ative o grupo de limites para a atribuição de sites.

Para desativar a atribuição de site para o grupo de limites, defina este valor como $null.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifique uma descrição opcional para este grupo de limites.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifique o ID de um grupo de limites a configurar. Este ID é a propriedade GroupID no objeto SMS_BoundaryGroup . Por exemplo, 33.

Tipo:String
Aliases:GroupId
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifique um objeto para um grupo de limites a configurar. Para obter um objeto de grupo de limites, utilize o cmdlet Get-CMBoundaryGroup .

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifique o nome de um grupo de limites a configurar.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NewName

Utilize este parâmetro para mudar o nome de um grupo de limites.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PassThru

Devolve um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PreferCloudDPOverDP

Configure a opção de grupo de limites para preferir origens baseadas na cloud em vez de origens no local. Para obter mais informações, veja Opções de grupo de limites para transferências de elementos da rede.

Tipo:Boolean
Aliases:PreferCloudDistributionPointOverDistributionPoint
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PreferDPOverPeer

Configure a opção de grupo de limites para preferir pontos de distribuição em vez de elementos na mesma sub-rede. Para ativar esta definição, ative também -AllowPeerDownload. Para obter mais informações, veja Opções de grupo de limites para transferências de elementos da rede.

Tipo:Boolean
Aliases:PreferDistributionPointOverPeerInSubnet
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveSiteSystemServer

Especifica um objeto de servidor do sistema de sites a remover do grupo de limites. Para obter este objeto, utilize o cmdlet Get-CMSiteSystemServer .

Para remover todos os servidores do sistema de sites, utilize o parâmetro -ClearSiteSystemServer .

Tipo:IResultObject[]
Aliases:RemoveSiteSystemServers
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RemoveSiteSystemServerName

Especifica o nome de um ou mais servidores do sistema de sites a remover do grupo de limites. Para remover todos os servidores do sistema de sites, utilize o parâmetro -ClearSiteSystemServer .

Tipo:String[]
Aliases:RemoveSiteSystemServerNames
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SubnetPeerDownloadOnly

Configure a opção de grupo de limites para utilizar apenas elementos da mesma sub-rede durante as transferências do elemento da rede. Para ativar esta definição, ative também -AllowPeerDownload. Para obter mais informações, veja Opções de grupo de limites para transferências de elementos da rede.

Tipo:Boolean
Aliases:PeerWithinSameSubnetOnly
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject