Compartilhar via


Set-OBMachineSetting

Define um objeto OBMachineSetting para o servidor.

Sintaxe

Set-OBMachineSetting
   [-EncryptionPassphrase] <SecureString>
   [[-SecurityPin] <String>][[-PassphraseSaveLocation] <String>]
   [[-KeyVaultUri] <String>]
   [-Confirm]
   [-WhatIf]
Set-OBMachineSetting
   [-WorkDay] <DayOfWeek[] {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday}>
   [-StartWorkHour] <TimeSpan>
   [-EndWorkHour] <TimeSpan>
   [-WorkHourBandwidth] <UInt32>
   [-NonWorkHourBandwidth] <UInt32>
   [-Confirm]
   [-WhatIf]
Set-OBMachineSetting
   [-NoProxy]
   [-Confirm]
   [-WhatIf]
Set-OBMachineSetting
   [-NoThrottle]
   [-Confirm]
   [-WhatIf]
Set-OBMachineSetting
   [-ProxyServer] <String>
   [-ProxyPort] <Int32>
   [[-ProxyUsername] <String>]
   [[-ProxyPassword] <SecureString>]
   [-Confirm]
   [-WhatIf]

Description

O cmdlet Set-OBMachineSetting define um objeto OBMachineSetting para o servidor que inclui configurações de servidor proxy para acessar a Internet, configurações de limitação de largura de banda de rede e a frase secreta de criptografia necessária para descriptografar os arquivos durante a recuperação para outro servidor.

Esse cmdlet dá suporte aos parâmetros WhatIf e Confirm com um impacto médio. O impacto médio significa que o cmdlet não solicitará confirmação ao usuário por padrão. O parâmetro WhatIf fornece uma descrição detalhada do que o cmdlet faz sem executar nenhuma operação. O parâmetro Confirm especifica se o cmdlet deve solicitar ao usuário. Usar -Confirm:$FALSE substituirá o prompt.

Para usar os cmdlets do Backup do Microsoft Azure, o usuário precisa ser um administrador no computador protegido.

Exemplos

EXEMPLO 1

$spwd = ConvertTo-SecureString -String Notag00pa55word -AsPlainText -Force 
Set-OBMachineSetting -EncryptionPassphrase $spwd -PassphraseSaveLocation C:\

Este exemplo define a frase secreta de criptografia para um computador.

EXEMPLO 2

$spwd = ConvertTo-SecureString -String Notag00pa55word -AsPlainText -Force



Set-OBMachineSetting -ProxyServer http://proxycontoso.com -ProxyPort <your proxy port> -ProxyUsername contoso\johnj99 -ProxyPassword $spwd

Este exemplo define as configurações de proxy para um servidor.

EXEMPLO 3

$mon = [System.DayOfWeek]::Monday



$tue = [System.DayOfWeek]::Tuesday



Set-OBMachineSetting -WorkDay $mon, $tue -StartWorkHour "9:00:00" -EndWorkHour "18:00:00" -WorkHourBandwidth (512*1024) -NonWorkHourBandwidth (2048*1024)

Este exemplo define as configurações de limitação.

EXEMPLO 4

Set-OBMachineSetting -NoThrottle

Este exemplo especifica que a limitação de largura de banda de rede não será usada por este servidor.

EXEMPLO 5

Set-OBMachineSetting -NoProxy

Este exemplo especifica que esse servidor não usa uma configuração exclusiva do servidor proxy.

EXEMPLO 6

$spwd = ConvertTo-SecureString -String abcdefgh123456000345 -AsPlainText -Force
Set-OBMachineSetting -EncryptionPassphrase $spwd -SecurityPIN 123456 -PassphraseSaveLocation "C:\Users\myuser\MyFolder \Desktop\passphrases\"

Este exemplo registra um servidor com a frase secreta fornecida e salva-o no local fornecido.

EXEMPLO 7

$spwd = ConvertTo-SecureString -String abcdefgh123456000345 -AsPlainText -Force
Set-OBMachineSetting -EncryptionPassphrase $spwd -SecurityPIN 123456 -KeyVaultUri "https://mykeyvault.vault.azure.net/"

Este exemplo registra um servidor com a frase secreta fornecida e salva-o no Azure Key Vault.

Parâmetros

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-EncryptionPassphrase

Define a senha de criptografia a ser usada para criptografar os dados de backup.

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

-EndWorkHour

Especifica a hora que encerra o intervalo de horas de trabalho.

Tipo:TimeSpan
Cargo:4
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-KeyVaultUri

Insira um URI do Key Vault para salvar a frase secreta com segurança. Um novo segredo é criado no cofre de chaves especificado para salvar a frase secreta. Um de PassphraseSaveLocation ou KeyVaultUri (recomendado) precisa ser especificado.

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

-NonWorkHourBandwidth

Especifica a configuração de limitação de largura de banda a ser usada para limitar a largura de banda de rede consumida pelas transferências de dados durante o horário não comercial.

Tipo:UInt32
Cargo:6
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NoProxy

Especifica que as configurações exclusivas do servidor proxy não devem ser usadas para backups online.

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

-NoThrottle

Especifica que a limitação de rede não é usada com backups online. As transferências de dados de itens de backup do servidor local para o servidor de Backup do Microsoft Azure usarão a largura de banda conforme necessário.

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

-PassphraseSaveLocation

Insira um local de rede ou pasta em que a frase secreta possa ser salva. Não é recomendável salvar a frase secreta no computador que está sendo protegido. A Microsoft não poderá recuperar dados de backup se a frase secreta for perdida. Um de PassphraseSaveLocation ou KeyVaultUri (recomendado) precisa ser especificado.

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

-ProxyPassword

Especifica a senha de autenticação a ser usada para a configuração de proxy.

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

-ProxyPort

Especifica o número da porta a ser usado no servidor proxy.

Tipo:Int32
Cargo:3
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ProxyServer

Especifica o servidor proxy a ser usado ao se conectar ao servidor de Backup do Microsoft Azure.

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

-ProxyUsername

Especifica o nome de usuário a ser usado para autenticação do servidor proxy.

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

-SecurityPin

O pin de segurança será necessário se você estiver alterando a frase secreta e a configuração de segurança híbrida estiver ativada para o Cofre dos Serviços de Recuperação. Você deve gerar um pin de segurança selecionando Gerar em Configurações > Propriedades > PIN de Segurança na seção cofre dos Serviços de Recuperação do portal do Azure.

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

-StartWorkHour

Especifica a hora que inicia o intervalo de horas de trabalho.

Tipo:TimeSpan
Cargo:3
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

-WorkDay

Especifica a matriz de dias úteis usando o uso [DayOfWeek] variáveis do sistema.

Tipo:DayOfWeek[] {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday}
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WorkHourBandwidth

Especifica a configuração de limitação de largura de banda a ser usada para limitar a largura de banda de rede consumida pelas transferências de dados durante o horário de trabalho.

Tipo:UInt32
Cargo:5
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting

Saídas

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting