Partilhar via


Set-OBMachineSetting

Define um objeto OBMachineSetting para o servidor.

Sintaxe

UNNAMED_PARAMETER_SET_1

Set-OBMachineSetting
    [-EncryptionPassphrase] <SecureString>
    [[-SecurityPin] <String>]
    [[-PassphraseSaveLocation] <String>]
    [[-KeyVaultUri] <String>]
    [-Confirm]
    [-WhatIf]

UNNAMED_PARAMETER_SET_2

Set-OBMachineSetting
    [-WorkDay] <DayOfWeek[]>
    [-StartWorkHour] <TimeSpan>
    [-EndWorkHour] <TimeSpan>
    [-WorkHourBandwidth] <UInt32>
    [-NonWorkHourBandwidth] <UInt32>
    [-Confirm]
    [-WhatIf]

UNNAMED_PARAMETER_SET_3

Set-OBMachineSetting
    [-NoProxy]
    [-Confirm]
    [-WhatIf]

UNNAMED_PARAMETER_SET_4

Set-OBMachineSetting
    [-NoThrottle]
    [-Confirm]
    [-WhatIf]

UNNAMED_PARAMETER_SET_5

Set-OBMachineSetting
    [-ProxyServer] <String>
    [-ProxyPort] <Int32>
    [[-ProxyUsername] <String>]
    [[-ProxyPassword] <SecureString>]
    [-Confirm]
    [-WhatIf]

Description

O Set-OBMachineSetting cmdlet 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. O uso -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
$setOBMachineSettingSplat = @{
    ProxyServer   = 'http://proxycontoso.com'
    ProxyPort     = '<your proxy port>'
    ProxyUsername = 'contoso\johnj99'
    ProxyPassword = $spwd
}
Set-OBMachineSetting @setOBMachineSettingSplat

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

EXEMPLO 3

$setOBMachineSettingSplat = @{
    WorkDay              = [System.DayOfWeek]::Monday, [System.DayOfWeek]::Tuesday
    StartWorkHour        = '9:00:00'
    EndWorkHour          = '18:00:00'
    WorkHourBandwidth    = (512*1024)
    NonWorkHourBandwidth = (2048*1024)
}
Set-OBMachineSetting @setOBMachineSettingSplat

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
$setOBMachineSettingSplat = @{
    EncryptionPassphrase = $spwd
    SecurityPIN = 123456
    PassphraseSaveLocation = 'C:\Users\myuser\MyFolder \Desktop\passphrases\'
}
Set-OBMachineSetting @setOBMachineSettingSplat

Este exemplo registra um servidor com a senha fornecida e a salva no local fornecido.

EXEMPLO 7

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

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.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-EncryptionPassphrase

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

Propriedades dos parâmetros

Tipo:SecureString
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_1
Position:2
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-EndWorkHour

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

Propriedades dos parâmetros

Tipo:TimeSpan
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_2
Position:4
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:3
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:UInt32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_2
Position:6
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-NoProxy

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_3
Position:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_4
Position:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:2
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ProxyPassword

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

Propriedades dos parâmetros

Tipo:SecureString
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_5
Position:5
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ProxyPort

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

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_5
Position:3
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ProxyServer

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_5
Position:2
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ProxyUsername

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_5
Position:4
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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çana seção Cofre dos Serviços de Recuperação do portal do Azure.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:3
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-StartWorkHour

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

Propriedades dos parâmetros

Tipo:TimeSpan
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_2
Position:3
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WorkDay

Especifica a matriz de dias de trabalho usando as [DayOfWeek] variáveis do sistema.

Propriedades dos parâmetros

Tipo:

DayOfWeek[]

Default value:None
Valores aceites:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_2
Position:2
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:UInt32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_2
Position:5
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

Entradas

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting

Saídas

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting