New-CMTSStepApplyNetworkSetting
Crie uma etapa Aplicar Configurações de Rede , que você pode adicionar a uma sequência de tarefas.
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
Este cmdlet cria um novo objeto de etapa Aplicar Configurações de Rede . Em seguida, use o cmdlet Add-CMTaskSequenceStep para adicionar a etapa a uma sequência de tarefas. Para obter mais informações sobre esta etapa, confira Sobre as etapas da sequência de tarefas: Aplicar Configurações de Rede.
Observação
Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, confira introdução.
Exemplos
Exemplo 1
Este exemplo usa primeiro o cmdlet interno ConvertTo-SecureString para criar uma cadeia de caracteres segura para a senha do usuário. Esse método é usado aqui como um exemplo simples, mas não o mais seguro, já que a senha de texto simples está no script. Para obter mais informações sobre esse cmdlet e outras opções, consulte ConvertTo-SecureString.
A próxima linha cria um objeto para a etapa Aplicar Configurações de Rede , usando a variável de senha de cadeia de caracteres segura.
Em seguida, ele obtém um objeto de sequência de tarefas e adiciona essa nova etapa à sequência de tarefas no índice 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
Parâmetros
-AddAdapterSetting
Especifique um objeto de configurações de adaptador de rede para adicionar a esta etapa. Para obter esse objeto, use o cmdlet New-CMTSNetworkAdapterSetting .
Type: | IResultObject[] |
Aliases: | AddAdapterSettings |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Condition
Especifique um objeto de condição a ser usado com esta etapa. Para obter esse objeto, use um dos cmdlets da condição de sequência de tarefas. Por exemplo, Get-CMTSStepConditionVariable.
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnError
Adicione esse parâmetro para habilitar a opção de etapa Continuar no erro. Quando você habilita essa opção, se a etapa falhar, a sequência de tarefas continuará.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifique uma descrição opcional para esta etapa de sequência de tarefas.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Disable
Adicione esse parâmetro para desabilitar essa etapa de sequência de tarefas.
Type: | SwitchParameter |
Aliases: | DisableThisStep |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DnsSuffix
Especifique o sufixo DNS. Por exemplo, corp.contoso.com
. Essa configuração é aplicada a todas as conexões com TCP/IP habilitadas.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainName
Para configurar essa etapa para que o computador ingresse em um domínio, use esse parâmetro para especificar o nome de um domínio a ser ingressado. Em seguida, use os seguintes outros parâmetros:
- DomainOU: opcionalmente especifique uma unidade organizacional na qual criar a nova conta de computador
- UserName: especifique a conta de usuário com permissões para ingressar um computador no domínio
- UserPassword: especifique a senha da conta de usuário.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DomainOU
Ao usar o parâmetro DomainName , você também pode especificar o caminho para uma OU (unidade organizacional). Quando o computador ingressar no domínio, se ele criar uma nova conta de computador, essa conta estará nesta OU.
Por exemplo, LDAP://OU=MyOu,DC=MyDom,DC=MyCompany,DC=com
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableTcpIpFiltering
Adicione esse parâmetro para habilitar a filtragem TCP/IP para a conexão.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifique um nome para esta etapa para identificá-lo na sequência de tarefas.
Type: | String |
Aliases: | StepName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserName
Ao usar o parâmetro DomainName , use esse parâmetro para especificar a conta de usuário de domínio usada para adicionar o computador de destino ao domínio. Use o parâmetro UserPassword para especificar a senha da conta.
Para obter mais informações, confira a conta de junção de domínio da sequência de tarefas.
Type: | String |
Aliases: | DomainUserName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPassword
Especifique a senha como uma cadeia de caracteres segura para o parâmetro UserName .
Type: | SecureString |
Aliases: | DomainUserPassword |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkgroupName
Para configurar essa etapa para que o computador ingresse em um grupo de trabalho, use esse parâmetro para especificar o nome do grupo de trabalho.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Saídas
IResultObject
Observações
Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_TaskSequence_ApplyNetworkSettingsAction classe WMI do servidor.
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de