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.
Uwaga
Uruchom Menedżer konfiguracji cmdlet z Menedżer konfiguracji lokacji, na przykład PS XYZ:\>
. Aby uzyskać więcej informacji, zobacz wprowadzenie.
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