New-CMTSStepApplyNetworkSetting
SYNOPSIS
Utwórz krok Zastosuj Ustawienia sieci, który można dodać do sekwencji zadań.
SYNTAX
New-CMTSStepApplyNetworkSetting [-AddAdapterSetting <IResultObject[]>] [-DnsSuffix <String>]
[-DomainName <String>] [-DomainOU <String>] [-EnableTcpIpFiltering] [-UserName <String>]
[-UserPassword <SecureString>] [-WorkgroupName <String>] [-Condition <IResultObject[]>] [-ContinueOnError]
[-Description <String>] [-Disable] -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling]
[-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
To polecenie cmdlet tworzy nowy obiekt kroku zastosuj Ustawienia sieci. Następnie użyj polecenia cmdlet Add-CMTaskSequenceStep, aby dodać krok do sekwencji zadań. Aby uzyskać więcej informacji na temat tego kroku, zobacz Informacje o krokach sekwencji zadań: Stosowanie Ustawienia.
Uwaga
Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\>
. Aby uzyskać więcej informacji, zobacz wprowadzenie.
EXAMPLES
Przykład 1
W tym przykładzie najpierw użyto wbudowanego polecenia cmdlet ConvertTo-SecureString, aby utworzyć bezpieczny ciąg hasła użytkownika. Ta metoda jest używana w tym miejscu jako prosty przykład, ale nie jest najbezpiecznsza, ponieważ hasło w postaci zwykłego tekstu znajduje się w skrypcie. Aby uzyskać więcej informacji na temat tego polecenia cmdlet i innych opcji, zobacz ConvertTo-SecureString.
Następny wiersz tworzy obiekt dla kroku Apply Network Ustawienia przy użyciu zmiennej hasła ciągu bezpiecznego.
Następnie pobiera obiekt sekwencji zadań i dodaje ten nowy krok do sekwencji zadań w indeksie 11.
$Secure_String_Pwd = ConvertTo-SecureString "P@ssW0rD!" -AsPlainText -Force
$step = New-CMTSStepApplyNetworkSetting -Name "Apply network settings" -DnsSuffix "corp.contoso.com" -DomainName "na.corp.contoso.com" -DomainOU "LDAP://OU=Ops,OU=ITS,DC=na,DC=corp,DC=contoso,DC=com" -UserName "contoso\_cmosdjoin" -UserPassword $Secure_String_Pwd
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11
PARAMETERS
-AddAdapterSetting
Określ obiekt ustawień karty sieciowej do dodania do tego kroku. Aby uzyskać ten obiekt, użyj polecenia cmdlet New-CMTSNetworkAdapterSetting.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddAdapterSettings
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Warunek
Określ obiekt warunku do użycia w tym kroku. Aby uzyskać ten obiekt, użyj jednego z polecenia cmdlet warunku sekwencji zadań. Na przykład Get-CMTSStepConditionVariable.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: Conditions
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-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
-ContinueOnError
Dodaj ten parametr, aby włączyć opcję kroku Kontynuuj w przypadku błędu. Jeśli ta opcja zostanie włączyć, jeśli krok zakończy się niepowodzeniem, sekwencja zadań będzie kontynuowana.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Description (Opis)
Podaj opcjonalny opis tego kroku sekwencji zadań.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Wyłącz
Dodaj ten parametr, aby wyłączyć ten krok sekwencji zadań.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: DisableThisStep
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
-DnsSuffix
Określ sufiks DNS. Na przykład corp.contoso.com
. To ustawienie jest stosowane do wszystkich połączeń z włączonym protokołem TCP/IP.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DomainName
Aby skonfigurować ten krok tak, aby komputer przyłączył się do domeny, użyj tego parametru, aby określić nazwę domeny do przyłączenia. Następnie użyj następujących innych parametrów:
- DomainOU: opcjonalnie określ jednostkę organizacyjną, w której chcesz utworzyć nowe konto komputera
- UserName: określ konto użytkownika z uprawnieniami do dołączania komputera do domeny
- UserPassword: określ hasło dla konta użytkownika.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DomainOU
W przypadku użycia parametru DomainName można również określić ścieżkę do jednostki organizacyjnej (OU). Po dołączeniu komputera do domeny, jeśli tworzy nowe konto komputera, to konto będzie w tej ujmie.
Na przykład LDAP://OU=MyOu,DC=MyDom,DC=MyCompany,DC=com
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableTcpIpFiltering
Dodaj ten parametr, aby włączyć filtrowanie protokołu TCP/IP dla połączenia.
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
-Name
Określ nazwę tego kroku, aby zidentyfikować ją w sekwencji zadań.
Type: String
Parameter Sets: (All)
Aliases: StepName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserName
W przypadku użycia parametru DomainName użyj tego parametru, aby określić konto użytkownika domeny używane do dodawania komputera docelowego do domeny. Użyj parametru UserPassword, aby określić hasło konta.
Aby uzyskać więcej informacji, zobacz konto dołączania do domeny sekwencji zadań.
Type: String
Parameter Sets: (All)
Aliases: DomainUserName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserPassword
Określ hasło jako bezpieczny ciąg dla parametru UserName.
Type: SecureString
Parameter Sets: (All)
Aliases: DomainUserPassword
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
-WorkgroupName
Aby skonfigurować ten krok tak, aby komputer dołączył do grupy roboczej, użyj tego parametru, aby określić nazwę grupy roboczej.
Type: String
Parameter Sets: (All)
Aliases:
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_ApplyNetworkSettingsAction
UWAGI
Aby uzyskać więcej informacji na temat tego obiektu zwracanego i jego właściwości, zobacz SMS_TaskSequence_ApplyNetworkSettingsAction klasy WMI serwera.
RELATED LINKS
Get-CMTSStepApplyNetworkSetting Remove-CMTSStepApplyNetworkSetting Set-CMTSStepApplyNetworkSetting