Delen via

New-CMTSStepApplyNetworkSetting

  • Artikel

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.

Get-CMTSStepApplyNetworkSetting Remove-CMTSStepApplyNetworkSetting Set-CMTSStepApplyNetworkSetting

New-CMTSNetworkAdapterSetting

Over takenreeksstappen: Netwerktaak Instellingen