Share via

Set-CMBoundary

  • Referência
Módulo:
ConfigurationManager

Configure um limite de site.

Syntax

Set-CMBoundary
   -InputObject <IResultObject>
   [-NewName <String>]
   [-NewType <BoundaryTypes>]
   [-NewValue <String>]
   [-PassThru]
   [-ValueStartsWith <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMBoundary
   -Id <String>
   [-NewName <String>]
   [-NewType <BoundaryTypes>]
   [-NewValue <String>]
   [-PassThru]
   [-ValueStartsWith <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMBoundary
   [-NewName <String>]
   [-NewType <BoundaryTypes>]
   [-NewValue <String>]
   [-PassThru]
   -Type <BoundaryTypes>
   -Value <String>
   [-ValueStartsWith <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para configurar um limite de site. Um limite é um local de rede que contém um ou mais dispositivos que você pode gerenciar. Um limite pode ser uma sub-rede IP, nome do site do Active Directory, prefixo IPv6, um intervalo de endereços IP ou uma VPN. Para obter mais informações, confira Definir limites de site e grupos de limites.

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 limite

Esse comando altera um nome de limite de Default-ADSite para ADSiteBoundary01.

Set-CMBoundary -Name "Default-ADSite" -NewName "ADSiteBoundary01"

Exemplo 2: modificar o valor de um limite usando um InputObject

Neste exemplo, o primeiro comando obtém um limite que tem a ID de 16777217 e o insere no objeto de entrada $BoundaryObj.

O segundo comando identifica o limite usando o objeto de entrada $BoundaryObj e modifica seu valor para IPSubnet17.

$BoundaryObj = Get-CMBoundary -Id "16777217"
Set-CMBoundary -InputObject $BoundaryObj -Value "IPSubnet17"

Parâmetros

-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

-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 uma ID (identificador de limite) para modificar. Esse valor é um inteiro, por exemplo 26.

Type:String
Aliases:BoundaryId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Especifique um objeto de limite a ser modificado. Para obter esse objeto, use o cmdlet Get-CMBoundary .

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NewName

Especifique um novo nome para um limite.

Type:String
Aliases:DisplayName, Name
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NewType

Especifique o tipo de limite.

Type:BoundaryTypes
Aliases:NewBoundaryType
Accepted values:IPSubnet, ADSite, IPV6Prefix, IPRange, Vpn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NewValue

Especifique os dados que definem o limite. Por exemplo, um valor de site do Active Directory pode ser Default-First-Site-Name.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Adicione esse parâmetro para retornar 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

-Type

Especifique um tipo de limite.

Type:BoundaryTypes
Aliases:BoundaryType
Accepted values:IPSubnet, ADSite, IPV6Prefix, IPRange, Vpn
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Value

Especifique os dados que descrevem o limite.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ValueStartsWith

Defina esse parâmetro para $true corresponder ao início de um nome de conexão ou descrição em vez de toda a cadeia de caracteres. Para obter mais informações, consulte Definir locais de rede como limites.

Type:Boolean
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

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_Boundary classe WMI do servidor.