Set-CMBoundaryGroup
SYNOPSIS
Modifique as propriedades de um grupo de fronteira.
SYNTAX
SetByValueMandatory (Padrão)
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
O cmdlet Set-CMBoundaryGroup modifica as propriedades de um grupo de fronteira. Um grupo de fronteiras é uma coleção de limites. Para obter mais informações, consulte definir os limites do site e os grupos de fronteira e o cmdlet New-CMBoundary.
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\>
. Para mais informações, consulte a partida.
EXAMPLES
Exemplo 1: Mudar o nome de um grupo de fronteira
Este comando renomea um grupo de fronteiras. Usa o Get-CMBoundaryGroup cmdlet para obter o objeto do grupo de fronteira e, em seguida, passa-o usando o operador do gasoduto.
Get-CMBoundaryGroup -Name "BGroup01" | Set-CMBoundaryGroup -NewName "BGroup00"
Exemplo 2: Adicionar um âmbito de segurança a um grupo de fronteira
Este comando adiciona o âmbito de segurança OSDeploymentScope ao grupo de fronteira BGroup02.
Set-CMBoundaryGroup -SecurityScopeAction AddMembership -SecurityScopeName "OSDeploymentScope" -Name "BGroup02"
Exemplo 3: Adicionar um servidor de sistema de site
Este comando utiliza o cmdlet Get-CMSiteSystemServer para obter um objeto de servidor e, em seguida, adiciona-o ao grupo de fronteira.
$server = Get-CMSiteSystemServer -Name "granitefalls.cloudapp.net"
Set-CMBoundaryGroup -Name "Remote BG" -AddSiteSystemServer $server
PARAMETERS
-AddSiteSystemServer
Especifique um objeto de servidor do sistema de site para adicionar a este grupo de limites. Os clientes do grupo de fronteira utilizam estes servidores para política e conteúdo. Pode adicionar pontos de gestão, pontos de distribuição, pontos de migração do Estado, pontos de atualização de software e gateways de gestão de nuvem. Para obter um objeto de servidor do sistema de site, utilize o cmdlet 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
Especifique o nome de domínio totalmente qualificado de um servidor do sistema de site para adicionar a este grupo de limites. Os clientes do grupo de fronteira utilizam estes servidores para política e conteúdo. Pode adicionar pontos de gestão, pontos de distribuição, pontos de migração do Estado, pontos de atualização de software e gateways de gestão de nuvem.
Importante
Este parâmetro requer o nome de domínio totalmente qualificado do servidor do site.
Type: String[]
Parameter Sets: (All)
Aliases: AddSiteSystemServerNames
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowPeerDownload
Configure a opção do grupo de fronteira para permitir transferências de pares neste grupo de fronteira. Para obter mais informações, consulte as opções do grupo Boundary para downloads por pares.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ClearSiteSystemServer
Adicione este parâmetro para remover todos os servidores do sistema de site referenciados do grupo de fronteira.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: ClearSiteSystemServers
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-PadrãoSiteseCode
Especifique o código do site para definir como o site designado e ative o grupo de limites para a atribuição do site.
Para desativar a atribuição do site para o grupo de fronteira, desa esta questão para $null
.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Descrição
Especifique uma descrição opcional para este grupo de fronteira.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- ID
Especifique o ID de um grupo de fronteira para configurar. Este ID é a propriedade groupID no objeto SMS_BoundaryGroup. Por exemplo, 33
.
Type: String
Parameter Sets: SetById
Aliases: GroupId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Especifique um objeto para um grupo de fronteira para configurar. Para obter um objeto de grupo de fronteira, utilize o cmdlet 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
Especifique o nome de um grupo de fronteira para configurar.
Type: String
Parameter Sets: SetByName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Novo Nome
Use este parâmetro para renomear um grupo de fronteira.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PrefereCloudDPOverDP
Configure a opção do grupo de fronteira para preferir fontes baseadas em nuvem em fontes no local. Para obter mais informações, consulte as opções do grupo Boundary para downloads por pares.
Type: Boolean
Parameter Sets: (All)
Aliases: PreferCloudDistributionPointOverDistributionPoint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PrefereDPOverPeer
Configure a opção do grupo de fronteira para preferir pontos de distribuição em vez de pares dentro da mesma sub-rede. Para ativar esta definição, também ative -AllowPeerDownload. Para obter mais informações, consulte as opções do grupo Boundary para downloads por pares.
Type: Boolean
Parameter Sets: (All)
Aliases: PreferDistributionPointOverPeerInSubnet
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoverSiteSistemserver
Especifica um objeto do servidor do sistema de site para 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.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: RemoveSiteSystemServers
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoverSiteSistemServerName
Especifica o nome de um ou mais servidores do sistema de site para remover do grupo de fronteira. Para remover todos os servidores do sistema de sites, utilize o parâmetro -ClearSiteSystemServer.
Type: String[]
Parameter Sets: (All)
Aliases: RemoveSiteSystemServerNames
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SubnetPeerDownloadOnly
Configure a opção do grupo de limites para utilizar apenas os pares dentro da mesma sub-rede durante os downloads por pares. Para ativar esta definição, também ative -AllowPeerDownload. Para obter mais informações, consulte as opções do grupo Boundary para downloads por pares.
Type: Boolean
Parameter Sets: (All)
Aliases: PeerWithinSameSubnetOnly
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- O QueIf
Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.