New-CMTSNetworkAdapterSetting
Créez un objet paramètres pour une carte réseau à l’étape Appliquer le réseau Paramètres séquence de tâches.
Syntax
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 cmdlet crée un objet de paramètres de carte réseau. Utilisez cet objet avec le paramètre AddAdapterSetting sur les cmdlets New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting.
Pour plus d’informations, voir À propos des étapes de la séquence de tâches : Appliquer la Paramètres.
Notes
Exécutez les cmdlets Configuration Manager à partir du lecteur de site Configuration Manager, par PS XYZ:\>
exemple. Pour plus d’informations, voir la mise en place.
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 $dns variable est un tableau avec deux adresses de serveur DNS. La $gw variable est un tableau avec deux adresses de passerelle. La $ip variable est un tableau avec deux tableaux de hachage. Chaque table de hachage définit une paire d’adresse IP et de masque de sous-réseau.
La ligne suivante de l’exemple utilise l’cmdlet New-CMTSNetworkAdapterSetting pour créer l’objet de paramètres de 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 d’application réseau existante Paramètres 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
- Confirmer
Une invite de confirmation apparaît avant d’exécuter le cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
- WhatIf
Présente ce qui se produit si le cmdlet s’exécute. La cmdlet ne s’exécute pas.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Ce paramètre traite les caractères génériques comme des valeurs littérales. Vous ne pouvez pas la combiner avec ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Dns
Spécifiez une ou plusieurs adresses de serveur DNS par ordre d’utilisation.
Type: | String[] |
Aliases: | DNSServerAddress, DNSServerAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableDnsRegistration
Ajoutez ce paramètre pour inscrire les adresses de cette connexion dans le 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 cmdlets New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 cmdlets New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableIpProtocolFiltering
Ajoutez ce paramètre pour filtrer certains protocoles IP. Pour activer le filtrage TCP/IP, utilisez le paramètre EnableTcpIpFiltering sur les cmdlets New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableLmHosts
Ajoutez ce paramètre pour activer la recherche LMHOSTS.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableTcpFiltering
Ajoutez ce paramètre pour filtrer certains ports TCP. Pour activer le filtrage TCP/IP, utilisez le paramètre EnableTcpIpFiltering sur les cmdlets New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableUdpFiltering
Ajoutez ce paramètre pour filtrer certains ports UDP. Pour activer le filtrage TCP/IP, utilisez le paramètre EnableTcpIpFiltering sur les cmdlets New-CMTSStepApplyNetworkSetting ou Set-CMTSStepApplyNetworkSetting.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 mesure automatique.
Type: | String[] |
Aliases: | GatewayIpAddress, GatewayIpAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IpAddress
Si cette connexion n’utilise pas DHCP, utilisez ce paramètre pour spécifier une ou plusieurs adresses IP et masques de sous-réseau correspondants. La valeur est un hachage. La première valeur est la IP
et la deuxième valeur est la 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 masques de sous-réseau, utilisez un tableau de tableaux de hachages.
Par exemple : @( @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }, @{ IP = "10.0.1.42"; Mask = "255.255.242.0"; } )
Type: | Hashtable[] |
Aliases: | NetworkSettingIpAddress, NetworkSettingIpAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Metric
Spécifiez la mesure qui indique le coût d’utilisation de la passerelle. Si vous ne spécifiez pas ce paramètre, la passerelle utilise une mesure automatique.
Type: | Int32 |
Aliases: | GatewayCostMetric |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Spécifiez un nom unique pour cette connexion.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TcpIpNetbiosOption
Spécifiez s’il faut activer ou désactiver NetBIOS sur TCP/IP.
Type: | NetbiosOption |
Accepted values: | Default, EnableNetbiosOverTcpip, DisableNetbiosOverTcpip |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Wins
Spécifiez une ou plusieurs adresses serveur WINS.
Type: | String[] |
Aliases: | WinsServerAddress, WinsServerAddresses |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
Néant
Sorties
IResultObject
Notes
Pour plus d’informations sur cet objet de retour et ses propriétés, voir SMS_TaskSequence_NetworkAdapterSettings classe WMI du serveur.