Dela via


New-CMTSStepApplyNetworkSetting

SYNOPSIS

Skapa ett Tillämpa Inställningar som du kan lägga till i en aktivitetssekvens.

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

Denna cmdlet skapar ett nytt Apply Network Inställningar step-objekt. Använd sedan cmdleten Add-CMTaskSequenceStep för att lägga till steget i en aktivitetssekvens. Mer information om det här steget finns i Om aktivitetssekvenssteg: Tillämpa Network Inställningar.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1

I det här exemplet används först den inbyggda cmdleten ConvertTo-SecureString för att skapa en säker sträng för användarlösenordet. Den här metoden används här som ett enkelt exempel, men inte det säkraste eftersom lösenordet för oformaterad text finns i skriptet. Mer information om den här cmdleten och andra alternativ finns i ConvertTo-SecureString.

Nästa rad skapar ett -objekt för steget Tillämpa Inställningar med hjälp av lösenordsvariabeln för säker sträng.

Den hämtar sedan ett aktivitetssekvensobjekt och lägger till det här nya steget i aktivitetssekvensen vid 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

Ange ett objekt för nätverkskortsinställningar som ska läggas till i det här steget. Hämta det här objektet med cmdleten New-CMTSNetworkAdapterSetting.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddAdapterSettings

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

-Condition

Ange ett villkorsobjekt som ska användas med det här steget. Hämta det här objektet genom att använda en av cmdletarna för aktivitetssekvensvillkor. Till exempel 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

Uppmanar dig att bekräfta innan du kör cmdleten.

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

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

-ContinueOnError

Lägg till den här parametern för att aktivera stegalternativet Fortsätt vid fel. Om steget misslyckas när du aktiverar det här alternativet fortsätter aktivitetssekvensen.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Beskrivning

Ange en valfri beskrivning för det här aktivitetssekvenssteget.

Type: String
Parameter Sets: (All)
Aliases:

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

-Inaktivera

Lägg till den här parametern för att inaktivera det här aktivitetssekvenssteget.

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

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-DnsSuffix

Ange DNS-suffixet. Till exempel corp.contoso.com. Den här inställningen tillämpas på alla anslutningar med TCP/IP aktiverat.

Type: String
Parameter Sets: (All)
Aliases:

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

-DomainName

Om du vill konfigurera det här steget så att datorn ansluter till en domän använder du den här parametern för att ange namnet på en domän som ska anslutas. Använd sedan följande andra parametrar:

  • Domän-OU: Om du vill kan du ange en organisationsenhet där det nya datorkontot ska skapas
  • Användarnamn: Ange användarkontot med behörighet att ansluta en dator till domänen
  • UserPassword: Ange lösenordet för användarkontot.
Type: String
Parameter Sets: (All)
Aliases:

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

-DomainOU

När du använder parametern DomainName kan du också ange sökvägen till en organisationsenhet (OU). När datorn ansluts till domänen, och om ett nytt datorkonto skapas, kommer det kontot att finnas i den här organisationsenheten.

Till exempel 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

Lägg till den här parametern för att aktivera TCP/IP-filtrering för anslutningen.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Name

Ange ett namn för det här steget för att identifiera det i aktivitetssekvensen.

Type: String
Parameter Sets: (All)
Aliases: StepName

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

-UserName

När du använder parametern DomainName använder du den här parametern för att ange domänanvändarkontot som används för att lägga till måldatorn i domänen. Använd parametern UserPassword för att ange kontolösenordet.

Mer information finns i domänmedlemskontot för aktivitetssekvenser.

Type: String
Parameter Sets: (All)
Aliases: DomainUserName

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

-UserPassword

Ange lösenordet som en säker sträng för parametern UserName.

Type: SecureString
Parameter Sets: (All)
Aliases: DomainUserPassword

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

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

-WorkgroupName

Om du vill konfigurera det här steget så att datorn ansluter till en arbetsgrupp använder du den här parametern för att ange arbetsgruppsnamnet.

Type: String
Parameter Sets: (All)
Aliases:

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Ingen

OUTPUTS

IResultObject#SMS_TaskSequence_ApplyNetworkSettingsAction

ANTECKNINGAR

Mer information om det här returobjektet och dess egenskaper finns i SMS_TaskSequence_ApplyNetworkSettingsAction serverns WMI-klass.

Get-CMTSStepApplyNetworkSetting Remove-CMTSStepApplyNetworkSetting Set-CMTSStepApplyNetworkSetting

New-CMTSNetworkAdapterSetting

Om aktivitetssekvenssteg: Tillämpa Inställningar