Set-CMBoundaryGroup
Modifique as propriedades de um grupo de limites.
Syntax
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, consulte Definir limites de site e grupos de limites e o cmdlet New-CMBoundary .
Observação
Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, confira introdução.
Exemplos
Exemplo 1: renomear um grupo de limites
Esse comando renomeia um grupo de limites. Ele usa o cmdlet Get-CMBoundaryGroup para obter o objeto de grupo de limites e, em seguida, passa-o usando o operador de pipeline.
Get-CMBoundaryGroup -Name "BGroup01" | Set-CMBoundaryGroup -NewName "BGroup00"
Exemplo 2: Adicionar um escopo de segurança a um grupo de limites
Esse comando adiciona o escopo 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 site
Esse comando usa 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 do servidor do sistema de site para adicionar a esse grupo de limites. Os clientes no grupo de limites usam esses servidores para política e conteúdo. Você pode adicionar pontos de gerenciamento, pontos de distribuição, pontos de migração de estado, pontos de atualização de software e gateways de gerenciamento de nuvem. Para obter um objeto de servidor do sistema de site, use o cmdlet Get-CMSiteSystemServer .
Type: | IResultObject[] |
Aliases: | AddSiteSystemServers |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddSiteSystemServerName
Especifique o nome de domínio totalmente qualificado de um servidor do sistema de site para adicionar a esse grupo de limites. Os clientes no grupo de limites usam esses servidores para política e conteúdo. Você pode adicionar pontos de gerenciamento, pontos de distribuição, pontos de migração de estado, pontos de atualização de software e gateways de gerenciamento de nuvem.
Importante
Esse parâmetro requer o nome de domínio totalmente qualificado do servidor do site.
Type: | String[] |
Aliases: | AddSiteSystemServerNames |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowPeerDownload
Configure a opção de grupo de limites para permitir downloads de pares neste grupo de limites. Para obter mais informações, consulte Opções de grupo limite para downloads por pares.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClearSiteSystemServer
Adicione esse parâmetro para remover todos os servidores do sistema de site referenciados do grupo de limites.
Type: | SwitchParameter |
Aliases: | ClearSiteSystemServers |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultSiteCode
Especifique o código do site a ser definido como o site atribuído e habilite o grupo de limites para atribuição do site.
Para desabilitar a atribuição do site para o grupo de limites, defina esse valor como $null
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifique uma descrição opcional para esse grupo de limites.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Especifique a ID de um grupo de limites a ser configurado. Essa ID é a propriedade GroupID no objeto SMS_BoundaryGroup . Por exemplo, 33
.
Type: | String |
Aliases: | GroupId |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifique um objeto para um grupo de limites a ser configurado. Para obter um objeto de grupo de limites, use o cmdlet Get-CMBoundaryGroup .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifique o nome de um grupo de limites a ser configurado.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewName
Use esse parâmetro para renomear um grupo de limites.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Retorna um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreferCloudDPOverDP
Configure a opção de grupo de limites para preferir fontes baseadas em nuvem em vez de fontes locais. Para obter mais informações, consulte Opções de grupo limite para downloads por pares.
Type: | Boolean |
Aliases: | PreferCloudDistributionPointOverDistributionPoint |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreferDPOverPeer
Configure a opção de grupo de limites para preferir pontos de distribuição em vez de pares na mesma sub-rede. Para habilitar essa configuração, habilite também -AllowPeerDownload. Para obter mais informações, consulte Opções de grupo limite para downloads por pares.
Type: | Boolean |
Aliases: | PreferDistributionPointOverPeerInSubnet |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveSiteSystemServer
Especifica um objeto do servidor do sistema de site para remover do grupo de limites. Para obter esse objeto, use o cmdlet Get-CMSiteSystemServer .
Para remover todos os servidores do sistema de site, use o parâmetro -ClearSiteSystemServer .
Type: | IResultObject[] |
Aliases: | RemoveSiteSystemServers |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveSiteSystemServerName
Especifica o nome de um ou mais servidores do sistema de sites a serem removidos do grupo de limites. Para remover todos os servidores do sistema de site, use o parâmetro -ClearSiteSystemServer .
Type: | String[] |
Aliases: | RemoveSiteSystemServerNames |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubnetPeerDownloadOnly
Configure a opção de grupo de limites para usar apenas pares na mesma sub-rede durante downloads por pares. Para habilitar essa configuração, habilite também -AllowPeerDownload. Para obter mais informações, consulte Opções de grupo limite para downloads por pares.
Type: | Boolean |
Aliases: | PeerWithinSameSubnetOnly |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
IResultObject
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de