New-CMTSStepApplyNetworkSetting
SYNOPSIS
Maak een stap Netwerk Instellingen, die u aan een takenreeks kunt toevoegen.
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
Met deze cmdlet maakt u een nieuw object Netwerk toepassen Instellingen stap. Gebruik vervolgens de cmdlet Add-CMTaskSequenceStep om de stap toe te voegen aan een takenreeks. Zie Over takenreeksstappen: Network Instellingen voor meer informatie over Instellingen.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1
In dit voorbeeld wordt eerst de ingebouwde cmdlet ConvertTo-SecureString gebruikt om een beveiligde tekenreeks voor het gebruikerswachtwoord te maken. Deze methode wordt hier gebruikt als een eenvoudig voorbeeld, maar niet de veiligste omdat het wachtwoord voor tekst zonder tekst in het script staat. Zie ConvertTo-SecureStringvoor meer informatie over deze cmdlet en andere opties.
Met de volgende regel maakt u een object voor de stap Netwerk toepassen Instellingen, met behulp van de wachtwoordvariabele voor de beveiligde tekenreeks.
Vervolgens wordt een takenreeksobject gemaakt en wordt deze nieuwe stap toegevoegd aan de takenreeks op index 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
Geef een object voor netwerkadapterinstellingen op dat u aan deze stap wilt toevoegen. Gebruik de cmdlet New-CMTSNetworkAdapterSetting om dit object op te halen.
Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddAdapterSettings
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Voorwaarde
Geef een voorwaardeobject op dat met deze stap moet worden gebruikt. Gebruik een van de cmdlets voor takenreeksvoorwaarde om dit object op te halen. Bijvoorbeeld 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
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
-ContinueOnError
Voeg deze parameter toe om de stapoptie Doorgaan bij fout in teschakelen. Wanneer u deze optie inschakelen als de stap mislukt, wordt de takenreeks voortgezet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Beschrijving
Geef een optionele beschrijving op voor deze takenreeksstap.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Uitschakelen
Voeg deze parameter toe om deze takenreeksstap uit te schakelen.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: DisableThisStep
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
-DnsSuffix
Geef het DNS-achtervoegsel op. Bijvoorbeeld corp.contoso.com. Deze instelling wordt toegepast op alle verbindingen met TCP/IP ingeschakeld.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DomainName
Als u deze stap zo wilt configureren dat de computer lid wordt van een domein, gebruikt u deze parameter om de naam op te geven van een domein dat u wilt toevoegen. Gebruik vervolgens de volgende andere parameters:
- Domein-OE: geef eventueel een organisatie-eenheid op waarin het nieuwe computeraccount moet worden gemaakt
- Gebruikersnaam: geef het gebruikersaccount op met machtigingen voor het toevoegen van een computer aan het domein
- UserPassword: geef het wachtwoord voor het gebruikersaccount op.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DomainOU
Wanneer u de parameter DomainName gebruikt, kunt u ook het pad naar een organisatie-eenheid (OE) opgeven. Wanneer de computer lid wordt van het domein en er een nieuw computeraccount wordt gemaakt, wordt dat account in deze OE.
Bijvoorbeeld: 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
Voeg deze parameter toe om TCP/IP-filtering voor de verbinding in teschakelen.
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
-Name
Geef een naam op voor deze stap om deze in de takenreeks te identificeren.
Type: String
Parameter Sets: (All)
Aliases: StepName
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-GebruikersNaam
Wanneer u de parameter DomainName gebruikt, gebruikt u deze parameter om het domeingebruikersaccount op te geven dat wordt gebruikt om de doelcomputer toe te voegen aan het domein. Gebruik de parameter UserPassword om het accountwachtwoord op te geven.
Zie het account voor het toevoegen van takenreeksdomeinen voor meer informatie.
Type: String
Parameter Sets: (All)
Aliases: DomainUserName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserPassword
Geef het wachtwoord op als een beveiligde tekenreeks voor de parameter UserName.
Type: SecureString
Parameter Sets: (All)
Aliases: DomainUserPassword
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
-WorkgroupName
Als u deze stap zo wilt configureren dat de computer lid wordt van een werkgroep, gebruikt u deze parameter om de werkgroepnaam op te geven.
Type: String
Parameter Sets: (All)
Aliases:
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_ApplyNetworkSettingsAction
OPMERKINGEN
Zie WMI-klasse SMS_TaskSequence_ApplyNetworkSettingsAction server voor meer informatie over dit retourobject en deeigenschappen ervan.
RELATED LINKS
Get-CMTSStepApplyNetworkSetting Remove-CMTSStepApplyNetworkSetting Set-CMTSStepApplyNetworkSetting