New-CMTSNetworkAdapterSetting
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.