Partager via

New-CMTSNetworkAdapterSetting

  • Référence
Module:
ConfigurationManager

Créez un objet de paramètres pour une carte réseau à l’étape de séquence de tâches Appliquer les paramètres réseau .

Syntaxe

New-CMTSNetworkAdapterSetting
   [-Dns <String[]>]
   [-EnableDnsRegistration]
   [-EnableFullDnsRegistration]
   [-EnableIpProtocolFiltering]
   [-EnableLmHosts]
   [-EnableTcpFiltering]
   [-EnableUdpFiltering]
   [-Gateway <String[]>]
   [-IpAddress <Hashtable[]>]
   [-IpProtocolFilterList <String[]>]
   [-Metric <Int32>]
   -Name <String>
   [-TcpFilterPortList <Int32[]>]
   [-TcpIpNetbiosOption <NetbiosOption>]
   [-UdpFilterPortList <Int32[]>]
   [-Wins <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cette applet de commande crée un objet de paramètres de carte réseau. Utilisez cet objet avec le paramètre AddAdapterSetting sur les applets de commande New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting .

Pour plus d’informations, consultez À propos des étapes de séquence de tâches : Appliquer les paramètres réseau.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Ajouter des paramètres de carte réseau pour une connexion avec plusieurs adresses

Cet exemple définit d’abord trois variables de tableau qui définissent les adresses multiples. La variable $dns est un tableau avec deux adresses de serveur DNS. La variable $gw est un tableau avec deux adresses de passerelle. La variable $ip est un tableau avec deux tables de hachage. Chaque table de hachage définit une paire d’adresses IP et de masque de sous-réseau.

La ligne suivante de l’exemple utilise l’applet de commande New-CMTSNetworkAdapterSetting pour créer l’objet paramètres de la carte réseau. Il utilise les variables définies et définit plusieurs autres options.

La dernière partie de cet exemple configure une étape Appliquer les paramètres réseau existante d’une séquence de tâches nommée Déploiement du système d’exploitation par défaut. Il ajoute les paramètres de carte réseau à l’étape et configure le suffixe DNS.

$dns = @("192.168.1.100","10.0.1.100")
$gw = @("192.168.1.1","10.0.1.1")

$ip = @(
    @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; },
    @{ IP = "10.0.1.42"; Mask = "255.255.242.0"; }
)

$conn1 = New-CMTSNetworkAdapterSetting -Name "local connection" -Dns $dns -EnableDnsRegistration -EnableFullDnsRegistration -Gateway $gw -IpAddress $ip -TcpIpNetbiosOption DisableNetbiosOverTcpip

$tsNameOsd = "Default OS deployment"
$tsStepNameApplyNetSet = "Apply Network Settings"

Set-CMTSStepApplyNetworkSetting -TaskSequenceName $tsNameOsd -StepName $tsStepNameApplyNetSet -AddAdapterSetting $conn1 -DnsSuffix "corp.contoso.com"

Paramètres

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Dns

Spécifiez une ou plusieurs adresses de serveur DNS dans l’ordre d’utilisation.

Type:String[]
Alias:DNSServerAddress, DNSServerAddresses
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableDnsRegistration

Ajoutez ce paramètre pour inscrire les adresses de cette connexion dans DNS. Ce paramètre s’applique à toutes les connexions avec TCP/IP activé. Pour spécifier le suffixe DNS, utilisez le paramètre DnsSuffix sur les applets de commande New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting .

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableFullDnsRegistration

Ajoutez ce paramètre pour utiliser le suffixe DNS de la connexion dans l’inscription DNS. Ce paramètre s’applique à toutes les connexions avec TCP/IP activé. Pour spécifier le suffixe DNS, utilisez le paramètre DnsSuffix sur les applets de commande New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting .

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableIpProtocolFiltering

Ajoutez ce paramètre pour filtrer certains protocoles IP. Pour activer le filtrage TCP/IP, utilisez le paramètre EnableTcpIpFiltering sur les applets de commande New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting .

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableLmHosts

Ajoutez ce paramètre pour activer la recherche LMHOSTS.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableTcpFiltering

Ajoutez ce paramètre pour filtrer certains ports TCP. Pour activer le filtrage TCP/IP, utilisez le paramètre EnableTcpIpFiltering sur les applets de commande New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting .

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableUdpFiltering

Ajoutez ce paramètre pour filtrer certains ports UDP. Pour activer le filtrage TCP/IP, utilisez le paramètre EnableTcpIpFiltering sur les applets de commande New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting .

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Gateway

Si cette connexion n’utilise pas DHCP, utilisez ce paramètre pour spécifier une ou plusieurs adresses de passerelle.

Si nécessaire, utilisez le paramètre Metric . Par défaut, la passerelle utilise une métrique automatique.

Type:String[]
Alias:GatewayIpAddress, GatewayIpAddresses
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IpAddress

Si cette connexion n’utilise pas DHCP, utilisez ce paramètre pour spécifier une ou plusieurs adresses IP et les masques de sous-réseau correspondants. La valeur est une table de hachage. La première valeur est le IP et la deuxième valeur est .Mask

Par exemple : @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }

Si vous devez spécifier plusieurs combinaisons d’adresses IP et de masque de sous-réseau, utilisez un tableau de tables de hachage.

Par exemple : @( @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }, @{ IP = "10.0.1.42"; Mask = "255.255.242.0"; } )

Type:Hashtable[]
Alias:NetworkSettingIpAddress, NetworkSettingIpAddresses
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IpProtocolFilterList

Lorsque vous utilisez le paramètre EnableIpProtocolFiltering , utilisez ce paramètre pour spécifier un ou plusieurs protocoles IP.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Metric

Spécifiez la métrique qui indique le coût d’utilisation de la passerelle. Si vous ne spécifiez pas ce paramètre, la passerelle utilise une métrique automatique.

Type:Int32
Alias:GatewayCostMetric
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifiez un nom unique pour cette connexion.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TcpFilterPortList

Lorsque vous utilisez le paramètre EnableTcpFiltering , utilisez ce paramètre pour spécifier un ou plusieurs ports TCP.

Type:Int32[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TcpIpNetbiosOption

Spécifiez s’il faut activer ou désactiver NetBIOS sur TCP/IP.

Type:NetbiosOption
Valeurs acceptées:Default, EnableNetbiosOverTcpip, DisableNetbiosOverTcpip
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UdpFilterPortList

Lorsque vous utilisez le paramètre EnableUdpFiltering , utilisez ce paramètre pour spécifier un ou plusieurs ports UDP.

Type:Int32[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Wins

Spécifiez une ou plusieurs adresses de serveur WINS.

Type:String[]
Alias:WinsServerAddress, WinsServerAddresses
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_TaskSequence_NetworkAdapterSettings classe WMI du serveur.