New-CMTSNetworkAdapterSetting

SYNOPSIS

Utwórz obiekt ustawień dla karty sieciowej w kroku sekwencji zadań Zastosuj Ustawienia sieci.

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

To polecenie cmdlet tworzy obiekt ustawień karty sieciowej. Użyj tego obiektu z parametrem AddAdapterSetting w poleceniach cmdlet New-CMTSStepApplyNetworkSetting lub Set-CMTSStepApplyNetworkSetting.

Aby uzyskać więcej informacji, zobacz About task sequence steps: Apply Network Ustawienia.

EXAMPLES

Przykład 1: Dodawanie ustawień karty sieciowej dla połączenia z wieloma adresami

W tym przykładzie najpierw zdefiniowano trzy zmienne tablicowe definiujące wiele adresów. Zmienn$ $dns jest tablicą z dwoma adresami serwerów DNS. Zmienn$ $gw jest tablicą z dwoma adresami bramy. Zmienn$ $ip jest tablicą z dwiema tablicami skrótów. Każda tablica skrótów definiuje parę adresów IP i maski podsieci.

W następnym wierszu przykładu użyto polecenia cmdlet New-CMTSNetworkAdapterSetting w celu utworzenia obiektu ustawień karty sieciowej. Używa zdefiniowanych zmiennych i ustawia kilka innych opcji.

Ostatnia część tego przykładu konfiguruje istniejący krok Zastosuj zasady Ustawienia sekwencji zadań o nazwie Domyślne wdrożenie systemu operacyjnego. Dodaje ustawienia karty sieciowej do kroku i konfiguruje sufiks 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"

PARAMETERS

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

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

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości literału znaków. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-DNS

Określ co najmniej jeden adres serwera DNS w kolejności użycia.

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

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

-EnableDnsRegistration

Dodaj ten parametr, aby zarejestrować adresy tego połączenia w systemie DNS. To ustawienie dotyczy wszystkich połączeń z włączonym protokołem TCP/IP. Aby określić sufiks DNS, użyj parametru DnsSuffix w poleceniach cmdlet New-CMTSStepApplyNetworkSetting lub Set-CMTSStepApplyNetworkSetting.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EnableFullDnsRegistration

Dodaj ten parametr, aby użyć sufiksu DNS połączenia w rejestracji DNS. To ustawienie dotyczy wszystkich połączeń z włączonym protokołem TCP/IP. Aby określić sufiks DNS, użyj parametru DnsSuffix w poleceniach cmdlet New-CMTSStepApplyNetworkSetting lub Set-CMTSStepApplyNetworkSetting.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EnableIpProtocolFiltering

Dodaj ten parametr, aby filtrować niektóre protokoły IP. Aby włączyć filtrowanie TCP/IP, użyj parametru EnableTcpIpFiltering w poleceniach cmdlet New-CMTSStepApplyNetworkSetting lub Set-CMTSStepApplyNetworkSetting.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EnableLmHosts

Dodaj ten parametr, aby włączyć odnośnik LMHOSTS.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EnableTcpFiltering

Dodaj ten parametr, aby filtrować niektóre porty TCP. Aby włączyć filtrowanie TCP/IP, użyj parametru EnableTcpIpFiltering w poleceniach cmdlet New-CMTSStepApplyNetworkSetting lub Set-CMTSStepApplyNetworkSetting.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EnableUdpFiltering

Dodaj ten parametr, aby filtrować niektóre porty UDP. Aby włączyć filtrowanie TCP/IP, użyj parametru EnableTcpIpFiltering w poleceniach cmdlet New-CMTSStepApplyNetworkSetting lub Set-CMTSStepApplyNetworkSetting.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Bramy

Jeśli to połączenie nie używa protokołu DHCP, użyj tego parametru, aby określić co najmniej jeden adres bramy.

W razie potrzeby użyj parametru Metryka. Domyślnie brama używa automatycznej metryki.

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

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

-IpAddress

Jeśli to połączenie nie używa protokołu DHCP, użyj tego parametru, aby określić co najmniej jeden adres IP i odpowiadające mu maski podsieci. Wartość jest tablicą skrótów. Pierwsza wartość to , IP a druga to Mask .

Na przykład: @{ IP = "192.168.1.42"; Mask = "255.255.255.0"; }

Jeśli musisz określić więcej niż jeden adres IP i kombinację maski podsieci, użyj tablicy tablic skrótów.

Na przykład: @( @{ 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

W przypadku użycia parametru EnableIpProtocolFiltering użyj tego parametru, aby określić co najmniej jeden protokół IP.

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

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

-Metryka

Określ metrykę, która wskazuje koszt używania bramy. Jeśli ten parametr nie zostanie określony, brama będzie używała automatycznej metryki.

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

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

-Name

Określ unikatową nazwę tego połączenia.

Type: String
Parameter Sets: (All)
Aliases:

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

-TcpFilterPortList

W przypadku użycia parametru EnableTcpFiltering użyj tego parametru, aby określić co najmniej jeden port TCP.

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

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

-TcpIpNetbiosOption

Określ, czy ma być włączana, czy wyłączana sieć NetBIOS za pośrednictwem protokołu 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

W przypadku użycia parametru EnableUdpFiltering użyj tego parametru, aby określić co najmniej jeden port UDP.

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

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

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

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

- Wins

Określ co najmniej jeden adres serwera WINS.

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

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

Brak

OUTPUTS

IResultObject#SMS_TaskSequence_NetworkAdapterSettings

UWAGI

Aby uzyskać więcej informacji na temat tego obiektu zwracanego i jego właściwości, zobacz SMS_TaskSequence_NetworkAdapterSettings klasy WMI serwera.

RELATED LINKS

New-CMTSStepApplyNetworkSetting Set-CMTSStepApplyNetworkSetting

Informacje o krokach sekwencji zadań: Stosowanie Ustawienia