Condividi tramite

Set-CMBoundary

  • Riferimento
Modulo:
ConfigurationManager

Configurare un limite del sito.

Sintassi

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>]

Descrizione

Usare questo cmdlet per configurare un limite del sito. Un limite è un percorso di rete che contiene uno o più dispositivi che è possibile gestire. Un limite può essere una subnet IP, il nome del sito di Active Directory, il prefisso IPv6, un intervallo di indirizzi IP o una VPN. Per altre informazioni, vedere Definire i limiti e i gruppi di limiti del sito.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Rinominare un limite

Questo comando modifica un nome di limite da Default-ADSite ad ADSiteBoundary01.

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

Esempio 2: Modificare il valore di un limite usando un oggetto InputObject

In questo esempio, il primo comando ottiene un limite con ID di 16777217 e lo inserisce nell'oggetto di input $BoundaryObj.

Il secondo comando identifica il limite usando l'oggetto di input $BoundaryObj e ne modifica il valore in IPSubnet17.

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

Parametri

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specificare un identificatore di limite (ID) da modificare. Questo valore è un numero intero, ad esempio 26.

Tipo:String
Alias:BoundaryId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specificare un oggetto limite da modificare. Per ottenere questo oggetto, usare il cmdlet Get-CMBoundary .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-NewName

Specificare un nuovo nome per un limite.

Tipo:String
Alias:DisplayName, Name
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NewType

Specificare il tipo di limite.

Tipo:BoundaryTypes
Alias:NewBoundaryType
Valori accettati:IPSubnet, ADSite, IPV6Prefix, IPRange, Vpn
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NewValue

Specificare i dati che definiscono il limite. Ad esempio, un valore del sito di Active Directory può essere Default-First-Site-Name.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Type

Specificare un tipo di limite.

Tipo:BoundaryTypes
Alias:BoundaryType
Valori accettati:IPSubnet, ADSite, IPV6Prefix, IPRange, Vpn
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Value

Specificare i dati che descrivono il limite.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ValueStartsWith

Impostare questo parametro su $true in modo che corrisponda all'inizio di un nome di connessione o di una descrizione anziché all'intera stringa. Per altre informazioni, vedere Definire i percorsi di rete come limiti.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_Boundary classe WMI del server.