Compartilhar via

Set-OBMachineSetting

Módulo:
MSOnlineBackup Module

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 de 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.

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á 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 solicitar ao usuário. O uso -Confirm:$FALSE substituirá o prompt.

Para usar cmdlets de 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 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 as 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 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 esse servidor.

EXEMPLO 5

Set-OBMachineSetting -NoProxy

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

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 Azure Key Vault.

Parâmetros

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EncryptionPassphrase

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

Propriedades do parâmetro

Tipo:SecureString
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_1
Cargo:2
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EndWorkHour

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

Propriedades do parâmetro

Tipo:TimeSpan
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_2
Cargo:4
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-KeyVaultUri

Insira um URI do Key Vault 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 do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:3
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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 fora do horário de trabalho.

Propriedades do parâmetro

Tipo:UInt32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_2
Cargo:6
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-NoProxy

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_4
Cargo:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PassphraseSaveLocation

Insira um local de rede ou pasta onde a senha possa ser salva. Não é recomendável salvar a senha 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 do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:2
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ProxyPassword

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

Propriedades do parâmetro

Tipo:SecureString
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_5
Cargo:5
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ProxyPort

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

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_5
Cargo:3
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ProxyServer

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_5
Cargo:2
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ProxyUsername

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_5
Cargo:4
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-SecurityPin

O PIN de segurança será 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 PIN 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 do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:3
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-StartWorkHour

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

Propriedades do parâmetro

Tipo:TimeSpan
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_2
Cargo:3
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WorkDay

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

Propriedades do parâmetro

Tipo:

DayOfWeek[]

Valor padrão:None
Valores aceitos:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_2
Cargo:2
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 do parâmetro

Tipo:UInt32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

UNNAMED_PARAMETER_SET_2
Cargo:5
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

Entradas

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting

Saídas

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting