Set-CMBoundary
Configure um limite de site.
Sintaxe
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.
Tipo: | SwitchParameter |
Aliases: | cf |
Cargo: | Named |
Valor padrão: | False |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Esse parâmetro trata caracteres curinga como valores de caractere literal. Você 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
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você 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 uma ID (identificador de limite) para modificar. Esse valor é um inteiro, por exemplo 26
.
Tipo: | String |
Aliases: | BoundaryId |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-InputObject
Especifique um objeto de limite a ser modificado. Para obter esse objeto, use o cmdlet Get-CMBoundary .
Tipo: | IResultObject |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-NewName
Especifique um novo nome para um limite.
Tipo: | String |
Aliases: | DisplayName, Name |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-NewType
Especifique o tipo de limite.
Tipo: | BoundaryTypes |
Aliases: | NewBoundaryType |
Valores aceitos: | IPSubnet, ADSite, IPV6Prefix, IPRange, Vpn |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-NewValue
Especifique os dados que definem o limite. Por exemplo, um valor de site do Active Directory pode ser Default-First-Site-Name
.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Type
Especifique um tipo de limite.
Tipo: | BoundaryTypes |
Aliases: | BoundaryType |
Valores aceitos: | IPSubnet, ADSite, IPV6Prefix, IPRange, Vpn |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Value
Especifique os dados que descrevem o limite.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
Tipo: | Boolean |
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
Observações
Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_Boundary classe WMI do servidor.
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