New-CMTSNetworkAdapterSetting

  • Artikel

SYNOPSIS

Skapa ett inställningsobjekt för ett nätverkskort i aktivitetssekvenssteget Tillämpa Inställningar nätverk.

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

Den här cmdleten skapar ett inställningsobjekt för nätverkskort. Använd det här objektet med parametern AddAdapterSetting på cmdletarna New-CMTSStepApplyNetworkSetting eller Set-CMTSStepApplyNetworkSetting.

Mer information finns i Om aktivitetssekvenssteg: Använd Network Inställningar.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Lägga till inställningar för nätverkskort för en anslutning med flera adresser

Det här exemplet definierar först tre matrisvariabler som definierar flera adresser. Variabel$ $dns är en matris med två DNS-serveradresser. Variabel$ $gw är en matris med två gatewayadresser. Variabel$ $ip är en matris med två hash-tabeller. Varje hash-tabell definierar en IP-adress och ett nätmaskpar.

Nästa rad i exemplet använder cmdleten New-CMTSNetworkAdapterSetting för att skapa objektet för nätverkskortsinställningar. Den använder de definierade variablerna och anger flera andra alternativ.

I den sista delen av det här exemplet konfigureras ett befintligt Tillämpa Inställningar i en aktivitetssekvens med namnet Standarddistribution av operativsystem. Den lägger till inställningarna för nätverkskort i steget och konfigurerar DNS-suffixet.

$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

Uppmanar dig att bekräfta innan du kör cmdleten.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Dns

Ange en eller flera DNS-serveradresser i användningsordning.

Type: String[]
Parameter Sets: (All)
Aliases: DNSServerAddress, DNSServerAddresses

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableDnsRegistration

Lägg till den här parametern för att registrera den här anslutningens adresser i DNS. Den här inställningen gäller för alla anslutningar med TCP/IP aktiverat. Om du vill ange DNS-suffixet använder du parametern DnsSuffix på cmdletarna New-CMTSStepApplyNetworkSetting eller Set-CMTSStepApplyNetworkSetting.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableFullDnsRegistration

Lägg till den här parametern för att använda anslutningens DNS-suffix i DNS-registreringen. Den här inställningen gäller för alla anslutningar med TCP/IP aktiverat. Om du vill ange DNS-suffixet använder du parametern DnsSuffix på cmdletarna New-CMTSStepApplyNetworkSetting eller Set-CMTSStepApplyNetworkSetting.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableIpProtocolFiltering

Lägg till den här parametern för att filtrera vissa IP-protokoll. Om du vill aktivera TCP/IP-filtrering använder du parametern EnableTcpIpFiltering på cmdletarna New-CMTSStepApplyNetworkSetting eller Set-CMTSStepApplyNetworkSetting.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableLmHosts

Lägg till den här parametern för att aktivera LMHOSTS-sökning.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableTcpFiltering

Lägg till den här parametern för att filtrera vissa TCP-portar. Om du vill aktivera TCP/IP-filtrering använder du parametern EnableTcpIpFiltering på cmdletarna New-CMTSStepApplyNetworkSetting eller Set-CMTSStepApplyNetworkSetting.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableUdpFiltering

Lägg till den här parametern för att filtrera vissa UDP-portar. Om du vill aktivera TCP/IP-filtrering använder du parametern EnableTcpIpFiltering på cmdletarna New-CMTSStepApplyNetworkSetting eller Set-CMTSStepApplyNetworkSetting.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Gateway

Om den här anslutningen inte använder DHCP använder du den här parametern för att ange en eller flera gatewayadresser.

Om det behövs använder du parametern Metric. Som standard använder gatewayen ett automatiskt mått.

Type: String[]
Parameter Sets: (All)
Aliases: GatewayIpAddress, GatewayIpAddresses

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-IpAddress

Om den här anslutningen inte använder DHCP använder du den här parametern för att ange en eller flera IP-adresser och motsvarande nätmasker. Värdet är en hash-tabell. Det första värdet är IP och det andra värdet är Mask .

Exempelvis: @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }

Om du behöver ange mer än en kombination av IP-adress och nätmask använder du en matris med hashtabeller.

Exempelvis: @( @{ 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

När du använder parametern EnableIpProtocolFiltering använder du den här parametern för att ange ett eller flera IP-protokoll.

Type: String[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Metric

Ange måttet som anger kostnaden för att använda gatewayen. Om du inte anger den här parametern använder gatewayen ett automatiskt mått.

Type: Int32
Parameter Sets: (All)
Aliases: GatewayCostMetric

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Name

Ange ett unikt namn för den här anslutningen.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TcpFilterPortList

När du använder parametern EnableTcpFiltering använder du den här parametern för att ange en eller flera TCP-portar.

Type: Int32[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TcpIpNetbiosOption

Ange om NetBIOS ska aktiveras eller inaktiveras via TCP/IP.

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

När du använder parametern EnableUdpFiltering använder du den här parametern för att ange en eller flera UDP-portar.

Type: Int32[]
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Wins

Ange en eller flera WINS-serveradresser.

Type: String[]
Parameter Sets: (All)
Aliases: WinsServerAddress, WinsServerAddresses

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Ingen

OUTPUTS

IResultObject#SMS_TaskSequence_NetworkAdapterSettings

ANTECKNINGAR

Mer information om det här returobjektet och dess egenskaper finns i SMS_TaskSequence_NetworkAdapterSettings serverns WMI-klass.

New-CMTSStepApplyNetworkSetting Set-CMTSStepApplyNetworkSetting

Om aktivitetssekvenssteg: Tillämpa Inställningar