New-CMTSStepJoinDomainWorkgroup
Crie um passo Associar Domínio ou Grupo de Trabalho , que pode adicionar a uma sequência de tarefas.
Sintaxe
New-CMTSStepJoinDomainWorkgroup
[-DomainName <String>]
[-OU <String>]
[-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 passo Join Domain ou Workgroup . Em seguida, utilize o cmdlet Add-CMTaskSequenceStep para adicionar o passo a uma sequência de tarefas. Para obter mais informações sobre este passo, veja Acerca dos passos da sequência de tarefas: Associar Domínio ou Grupo de Trabalho.
Observação
Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.
Exemplos
Exemplo 1
Este exemplo utiliza primeiro o cmdlet incorporado ConvertTo-SecureString para criar uma cadeia segura para a palavra-passe de utilizador. Este método é utilizado aqui como um exemplo simples, mas não o mais seguro, uma vez que a palavra-passe de texto simples está no script. Para obter mais informações sobre este cmdlet e outras opções, veja ConvertTo-SecureString.
A linha seguinte cria um objeto para o passo Associar Domínio ou Grupo de Trabalho , utilizando a variável de palavra-passe de cadeia segura.
Em seguida, obtém um objeto de sequência de tarefas e adiciona este novo passo à sequência de tarefas no índice 11.
$Secure_String_Pwd = ConvertTo-SecureString "P@ssW0rD!" -AsPlainText -Force
$step = New-CMTSStepJoinDomainWorkgroup -Name "Join Domain or Workgroup" -DomainName "na.corp.contoso.com" -OU "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 11Parâmetros
-Condition
Especifique um objeto de condição a utilizar com este passo. Para obter este objeto, utilize um dos cmdlets da condição de sequência de tarefas. Por exemplo, Get-CMTSStepConditionVariable.
| Tipo: | IResultObject[] |
| Aliases: | Conditions |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
| Tipo: | SwitchParameter |
| Aliases: | cf |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ContinueOnError
Adicione este parâmetro para ativar a opção de passo Continuar com o erro. Quando ativa esta opção, se o passo falhar, a sequência de tarefas continuará.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Description
Especifique uma descrição opcional para este passo de sequência de tarefas.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Disable
Adicione este parâmetro para desativar este passo de sequência de tarefas.
| Tipo: | SwitchParameter |
| Aliases: | DisableThisStep |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DisableWildcardHandling
Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-DomainName
Para configurar este passo para que o computador se associe a um domínio, utilize este parâmetro para especificar o nome de um domínio a associar. Em seguida, utilize os seguintes outros parâmetros:
- DomainOU: opcionalmente, especifique uma unidade organizacional na qual criar a nova conta de computador.
- Nome de Utilizador: especifique a conta de utilizador com permissões para associar um computador ao domínio.
- UserPassword: especifique a palavra-passe da conta de utilizador.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-ForceWildcardHandling
Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Name
Especifique um nome para este passo para identificá-lo na sequência de tarefas.
| Tipo: | String |
| Aliases: | StepName |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-OU
Quando utiliza o parâmetro DomainName , também pode especificar o caminho para uma unidade organizacional (UO). Quando o computador associa o domínio, se criar uma nova conta de computador, essa conta estará nesta UO.
Por exemplo, LDAP://OU=MyOu,DC=MyDom,DC=MyCompany,DC=com
| Tipo: | String |
| Aliases: | OrganizationalUnit |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-UserName
Quando utilizar o parâmetro DomainName , utilize este parâmetro para especificar a conta de utilizador de domínio utilizada para adicionar o computador de destino ao domínio. Utilize o parâmetro UserPassword para especificar a palavra-passe da conta.
Para obter mais informações, veja a conta de associação a um domínio de sequência de tarefas.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-UserPassword
Especifique a palavra-passe como uma cadeia segura para o parâmetro UserName .
| Tipo: | SecureString |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Tipo: | SwitchParameter |
| Aliases: | wi |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-WorkgroupName
Para configurar este passo para que o computador se associe a um grupo de trabalho, utilize este parâmetro para especificar o nome do grupo de trabalho.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Entradas
None
Saídas
IResultObject
Observações
Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_TaskSequence_JoinDomainWorkgroupAction classe WMI de servidor.