New-CMTSNetworkAdapterSetting
SYNOPSIS
Maak een instellingenobject voor een netwerkadapter in de takenreeksstap Instellingen netwerkadapter toepassen.
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
Met deze cmdlet maakt u een object voor netwerkadapterinstellingen. Gebruik dit object met de parameter AddAdapterSetting in de cmdlets New-CMTSStepApplyNetworkSetting of Set-CMTSStepApplyNetworkSetting.
Zie Over takenreeksstappen: Network Instellingen voor meer Instellingen.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: Netwerkadapterinstellingen toevoegen voor een verbinding met meerdere adressen
In dit voorbeeld worden eerst drie matrixvariabelen definieert die de meerdere adressen definiëren. De $dns variabele is een matrix met twee DNS-serveradressen. De $gw variabele is een matrix met twee gatewayadressen. De $ip variabele is een matrix met twee hashtabels. Elke hashtabel definieert een IP-adres en subnetmaskerpaar.
In de volgende regel van het voorbeeld wordt de cmdlet New-CMTSNetworkAdapterSetting gebruikt om het instellingenobject voor de netwerkadapter te maken. Hierbij worden de gedefinieerde variabelen gebruikt en worden verschillende andere opties in stellen.
In het laatste deel van dit voorbeeld wordt een bestaande stap Netwerk toepassen Instellingen van een takenreeks met de naam Standaardbesturingssysteemimplementatie geconfigureerd. De netwerkadapterinstellingen worden toegevoegd aan de stap en het DNS-achtervoegsel wordt geconfigureerd.
$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"
PARAMETERS
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Dns
Geef een of meer DNS-serveradressen op in volgorde van gebruik.
Type: String[]
Parameter Sets: (All)
Aliases: DNSServerAddress, DNSServerAddresses
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableDnsRegistration
Voeg deze parameter toe om de adressen van deze verbinding in DNS te registreren. Deze instelling is van toepassing op alle verbindingen met TCP/IP ingeschakeld. Als u het DNS-achtervoegsel wilt opgeven, gebruikt u de parameter DnsSuffix in de cmdlets New-CMTSStepApplyNetworkSetting of Set-CMTSStepApplyNetworkSetting.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableFullDnsRegistration
Voeg deze parameter toe om het DNS-achtervoegsel van de verbinding te gebruiken in DNS-registratie. Deze instelling is van toepassing op alle verbindingen met TCP/IP ingeschakeld. Als u het DNS-achtervoegsel wilt opgeven, gebruikt u de parameter DnsSuffix in de cmdlets New-CMTSStepApplyNetworkSetting of Set-CMTSStepApplyNetworkSetting.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableIpProtocolFiltering
Voeg deze parameter toe om een aantal IP-protocollen te filteren. Als u TCP/IP-filtering wilt inschakelen, gebruikt u de parameter EnableTcpIpFiltering in de cmdlets New-CMTSStepApplyNetworkSetting of Set-CMTSStepApplyNetworkSetting.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableLmHosts
Voeg deze parameter toe om LMHOSTS-zoekactie in teschakelen.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableTcpFiltering
Voeg deze parameter toe om een aantal TCP-poorten te filteren. Als u TCP/IP-filtering wilt inschakelen, gebruikt u de parameter EnableTcpIpFiltering in de cmdlets New-CMTSStepApplyNetworkSetting of Set-CMTSStepApplyNetworkSetting.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableUdpFiltering
Voeg deze parameter toe om enkele UDP-poorten te filteren. Als u TCP/IP-filtering wilt inschakelen, gebruikt u de parameter EnableTcpIpFiltering in de cmdlets New-CMTSStepApplyNetworkSetting of Set-CMTSStepApplyNetworkSetting.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Gateway
Als deze verbinding geen gebruik maakt van DHCP, gebruikt u deze parameter om een of meer gatewayadressen op te geven.
Gebruik zo nodig de parameter Metrische waarde. De gateway maakt standaard gebruik van automatische metrische gegevens.
Type: String[]
Parameter Sets: (All)
Aliases: GatewayIpAddress, GatewayIpAddresses
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IpAddress
Als deze verbinding geen DHCP gebruikt, gebruikt u deze parameter om een of meer IP-adressen en bijbehorende subnetmaskers op te geven. De waarde is een hashtabel. De eerste waarde is de IP en de tweede waarde is de Mask .
Bijvoorbeeld: @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }
Als u meer dan één combinatie van IP-adres en subnetmasker moet opgeven, gebruikt u een matrix van hashtabels.
Bijvoorbeeld: @( @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }, @{ IP = "10.0.1.42"; Mask = "255.255.242.0"; } )
Type: Hashtable[]
Parameter Sets: (All)
Aliases: NetworkSettingIpAddress, NetworkSettingIpAddresses
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IpProtocolFilterList
Wanneer u de parameter EnableIpProtocolFiltering gebruikt, gebruikt u deze parameter om een of meer IP-protocollen op te geven.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Metrische gegevens
Geef de metrische gegevens op die de kosten voor het gebruik van de gateway aangeven. Als u deze parameter niet opgeeft, gebruikt de gateway een automatische metrische waarde.
Type: Int32
Parameter Sets: (All)
Aliases: GatewayCostMetric
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Geef een unieke naam op voor deze verbinding.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TcpFilterPortList
Wanneer u de parameter EnableTcpFiltering gebruikt, gebruikt u deze parameter om een of meer TCP-poorten op te geven.
Type: Int32[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TcpIpNetbiosOption
Geef op of NetBIOS via TCP/IP moet worden in- of uitgeschakeld.
Type: NetbiosOption
Parameter Sets: (All)
Aliases:
Accepted values: Default, EnableNetbiosOverTcpip, DisableNetbiosOverTcpip
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UdpFilterPortList
Wanneer u de parameter EnableUdpFiltering gebruikt, gebruikt u deze parameter om een of meer UDP-poorten op te geven.
Type: Int32[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Wins
Geef een of meer WINS-serveradressen op.
Type: String[]
Parameter Sets: (All)
Aliases: WinsServerAddress, WinsServerAddresses
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.
INPUTS
Geen
OUTPUTS
IResultObject#SMS_TaskSequence_NetworkAdapterSettings
OPMERKINGEN
Zie WMI-klasse SMS_TaskSequence_NetworkAdapterSettings server voor meer informatie over dit retourobject en deeigenschappen ervan.
RELATED LINKS
New-CMTSStepApplyNetworkSetting Set-CMTSStepApplyNetworkSetting