Set-OBMachineSetting

  • Referência
Módulo:
MSOnlineBackup

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 do servidor proxy para acessar a Internet, configurações de limitação de largura de banda de rede e a senha de criptografia necessária para descriptografar os arquivos durante a recuperação para outro servidor.

Este cmdlet suporta parâmetros WhatIf e Confirm com um impacto médio. O impacto médio significa que o cmdlet não solicitará a confirmação do 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 avisar o usuário. Usar -Confirm:$FALSE substituirá o prompt.

Para usar cmdlets do Backup do Microsoft Azure, o usuário precisa ser um administrador na máquina protegida.

Exemplos

EXEMPLO 1

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

Este exemplo define a senha 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 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 configurações de limitação.

EXEMPLO 4

Set-OBMachineSetting -NoThrottle

Este exemplo especifica que a limitação da largura de banda da 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 de 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 senha fornecida e a salva 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 senha fornecida e a salva no Cofre da Chave do Azure.

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-EncryptionPassphrase

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

Tipo:SecureString
Position:2
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-EndWorkHour

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

Tipo:TimeSpan
Position:4
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-KeyVaultUri

Insira um URI do Cofre da Chave para salvar a senha com segurança. Um novo segredo é criado no cofre de chaves especificado para salvar a senha. Um dos PassphraseSaveLocation ou KeyVaultUri (recomendado) precisa ser especificado.

Tipo:String
Position:3
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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 por transferências de dados durante o horário de folga.

Tipo:UInt32
Position:6
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-NoProxy

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

Tipo:SwitchParameter
Position:2
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 largura de banda conforme necessário.

Tipo:SwitchParameter
Position:2
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PassphraseSaveLocation

Insira um local de rede ou uma pasta onde a senha possa ser salva. Não é recomendável salvar a frase secreta na máquina que está sendo protegida. A Microsoft não pode recuperar dados de backup se a senha for perdida. Um dos PassphraseSaveLocation ou KeyVaultUri (recomendado) precisa ser especificado.

Tipo:String
Position:2
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ProxyPassword

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

Tipo:SecureString
Position:5
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ProxyPort

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

Tipo:Int32
Position:3
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ProxyServer

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

Tipo:String
Position:2
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ProxyUsername

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

Tipo:String
Position:4
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-SecurityPin

O pino de segurança é necessário se você estiver alterando a senha e a configuração de segurança híbrida estiver ativada para o Cofre dos Serviços de Recuperação. Você deve gerar um pino 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
Position:named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-StartWorkHour

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

Tipo:TimeSpan
Position:3
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

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

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WorkDay

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

Tipo:DayOfWeek[] {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday}
Position:2
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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 por transferências de dados durante o horário de trabalho.

Tipo:UInt32
Position:5
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting

Saídas

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting