New-CMTSStepEnableBitLocker

Crie um passo Ativar BitLocker , que pode adicionar a uma sequência de tarefas.

Sintaxe

New-CMTSStepEnableBitLocker
   [-CreateKeyOption <CreateKeyType>]
   [-Drive <String>]
   [-EnableSkipWhenNoValidTpm <Boolean>]
   [-EncryptFullDisk]
   [-EncryptionMethod <DiskEncryptionMethod>]
   [-Pin <SecureString>]
   [-TpmAndPin]
   [-TpmAndUsb]
   [-TpmOnly]
   [-UsbOnly]
   [-WaitForBitLockerComplete]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Este cmdlet cria um novo objeto de passo Ativar BitLocker . 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: Ativar o BitLocker.

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 cria um objeto para o passo Ativar BitLocker para TPM apenas com várias outras opções.

Em seguida, obtém um objeto de sequência de tarefas e adiciona este novo passo à sequência de tarefas no índice 11.

$step = New-CMTSStepEnableBitLocker -Name "Enable BitLocker" -TpmOnly -CreateKeyOption ActiveDirectoryDomainServices -EncryptionMethod AES_256 -EnableSkipWhenNoValidTpm $false -EncryptFullDisk $false -WaitForBitLockerComplete $false

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11

Parâ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

-CreateKeyOption

Utilize um dos seguintes valores para especificar onde criar a chave de recuperação:

  • ActiveDirectoryDomainServices: crie a palavra-passe de recuperação e coloque-a no Active Directory (recomendado)
  • DoNotCreateRecoveryKey: encripte a unidade, mas não crie uma palavra-passe de recuperação.
Tipo:CreateKeyType
Valores aceitos:ActiveDirectoryDomainServices, DoNotCreateRecoveryKey
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

-Drive

Especifique a unidade a encriptar. Se não especificar este parâmetro, o passo encripta a unidade de SO atual.

Tipo:String
Aliases:SpecificDrive
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableSkipWhenNoValidTpm

Aplica-se à versão 2006 e posterior. Defina este parâmetro como para true ignorar este passo para computadores que não têm um TPM ou quando o TPM não está ativado.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EncryptFullDisk

Adicione este parâmetro para utilizar a encriptação de disco completa. Por predefinição, o passo Ativar BitLocker encripta apenas o espaço utilizado na unidade.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EncryptionMethod

Aplica-se à versão 2006 e posterior. Utilize este parâmetro para especificar o modo de encriptação do disco. Por predefinição ou se não for especificado, o passo continua a utilizar o método de encriptação predefinido para a versão do SO.

Tipo:DiskEncryptionMethod
Aliases:DiskEncryptionMethod
Valores aceitos:DoNotSpecify, AES_128, AES_256, XTS_AES128, XTS_AES256, TotalCount
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

-Pin

Se utilizar o parâmetro TpmAndPin, utilize este parâmetro para especificar o valor do PIN. Especifique 4 a 20 números inteiros como uma cadeia segura.

Tipo:SecureString
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TpmAndPin

Adicione este parâmetro para configurar a gestão de chaves para a unidade do SO para utilizar um TPM e um número de identificação pessoal (PIN). Quando especifica esta opção, o BitLocker bloqueia o processo de arranque normal até o utilizador fornecer o PIN. Se utilizar este parâmetro, utilize Afixar para especificar o valor do PIN. Não pode combinar este parâmetro com TpmAndUsb, TpmOnly ou UsbOnly.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TpmAndUsb

Adicione este parâmetro para configurar a gestão de chaves para a unidade de SO para utilizar um TPM e uma chave de arranque armazenada numa pen USB. Quando seleciona esta opção, o BitLocker bloqueia o processo de arranque normal até que um dispositivo USB que contenha uma chave de arranque BitLocker esteja ligado ao computador. Não pode combinar este parâmetro com TpmAndPin, TpmOnly ou UsbOnly.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TpmOnly

Adicione este parâmetro para configurar a gestão de chaves para a unidade do SO para utilizar apenas um TPM. Não pode combinar este parâmetro com TpmAndPin, TpmAndUsb ou UsbOnly.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UsbOnly

Adicione este parâmetro para configurar a gestão de chaves para a unidade do SO para utilizar apenas uma chave de arranque armazenada numa pen USB. Quando seleciona esta opção, o BitLocker bloqueia o processo de arranque normal até que um dispositivo USB que contenha uma chave de arranque BitLocker esteja ligado ao computador. Não pode combinar este parâmetro com TpmAndPin, TpmAndUsb ou TpmOnly.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WaitForBitLockerComplete

Adicione este parâmetro para configurar o passo para aguardar que o BitLocker conclua o processo de encriptação de unidade em todas as unidades antes de continuar a execução da sequência de tarefas.

Tipo:SwitchParameter
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. Não executa o cmdlet .

Tipo:SwitchParameter
Aliases:wi
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_EnableBitLockerAction classe WMI de servidor.