Set-OBMachineSetting

为服务器设置 OBMachineSetting 对象。

语法

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]

说明

Set-OBMachineSetting cmdlet 为服务器设置一个 OBMachineSetting 对象,该对象包括用于访问 Internet 的代理服务器设置、网络带宽限制设置,以及在恢复到另一台服务器期间解密文件所需的加密密码。

此 cmdlet 支持具有中等影响的 WhatIfConfirm 参数。 中等影响表示默认情况下,cmdlet 不会提示用户进行确认。 WhatIf 参数提供了 cmdlet 在不执行任何作的情况下执行的作的详细描述。 Confirm 参数指定 cmdlet 是否应提示用户。 Using -Confirm:$FALSE 将覆盖提示。

若要使用 Microsoft Azure 备份 cmdlet,用户需要是受保护计算机上的管理员。

示例

示例 1

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

此示例为计算机设置加密密码。

示例 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

此示例设置服务器的代理设置。

示例 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

此示例设置限制设置。

示例 4

Set-OBMachineSetting -NoThrottle

此示例指定此服务器不会使用网络带宽限制。

示例 5

Set-OBMachineSetting -NoProxy

此示例指定此服务器不使用唯一的代理服务器配置。

示例 6

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

此示例使用给定的密码注册服务器,并将其保存在提供的位置。

示例 7

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

此示例使用给定的密码注册服务器,并将其保存在 Azure Key Vault 中。

参数

-Confirm

在运行 cmdlet 之前,提示你进行确认。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EncryptionPassphrase

设置用于加密备份数据的加密密码。

参数属性

类型:SecureString
默认值:None
支持通配符:False
不显示:False

参数集

UNNAMED_PARAMETER_SET_1
Position:2
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EndWorkHour

指定结束工作时间范围的小时数。

参数属性

类型:TimeSpan
默认值:None
支持通配符:False
不显示:False

参数集

UNNAMED_PARAMETER_SET_2
Position:4
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-KeyVaultUri

输入 Key Vault URI 以安全地保存密码。 将在指定的密钥保管库中创建新密钥,以保存密码。 需要指定 PassphraseSaveLocation 或 KeyVaultUri (recommended) 之一。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:3
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-NonWorkHourBandwidth

指定带宽限制设置,用于限制非工作时间数据传输所消耗的网络带宽。

参数属性

类型:UInt32
默认值:None
支持通配符:False
不显示:False

参数集

UNNAMED_PARAMETER_SET_2
Position:6
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-NoProxy

指定唯一代理服务器设置不用于联机备份。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

UNNAMED_PARAMETER_SET_3
Position:2
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-NoThrottle

指定网络限制不用于联机备份。 将备份项从本地服务器传输到 Microsoft Azure 备份服务器将根据需要使用带宽。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

UNNAMED_PARAMETER_SET_4
Position:2
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PassphraseSaveLocation

输入可以保存密码的网络位置或文件夹。 不建议将密码保存在受保护的计算机中。 如果密码丢失,Microsoft 将无法恢复备份数据。 需要指定 PassphraseSaveLocation 或 KeyVaultUri (recommended) 之一。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:2
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ProxyPassword

指定要用于代理设置的认证密码。

参数属性

类型:SecureString
默认值:None
支持通配符:False
不显示:False

参数集

UNNAMED_PARAMETER_SET_5
Position:5
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ProxyPort

指定要在 Proxy Server 上使用的端口号。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

UNNAMED_PARAMETER_SET_5
Position:3
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ProxyServer

指定连接到 Microsoft Azure 备份服务器时要使用的代理服务器。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

UNNAMED_PARAMETER_SET_5
Position:2
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ProxyUsername

指定要用于代理服务器身份验证的用户名。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

UNNAMED_PARAMETER_SET_5
Position:4
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-SecurityPin

如果要更改密码,并且为恢复服务保管库启用了混合安全设置,则需要安全 PIN。 必须通过在 Azure 门户的“恢复服务保管库”部分的“设置>属性>”下选择“生成”来生成安全 PIN。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:3
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-StartWorkHour

指定开始工作时间范围的小时。

参数属性

类型:TimeSpan
默认值:None
支持通配符:False
不显示:False

参数集

UNNAMED_PARAMETER_SET_2
Position:3
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未能运行。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WorkDay

使用 using [DayOfWeek] 系统变量指定工作日数组。

参数属性

类型:

DayOfWeek[]

默认值:None
接受的值:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
支持通配符:False
不显示:False

参数集

UNNAMED_PARAMETER_SET_2
Position:2
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WorkHourBandwidth

指定带宽限制设置,用于限制工作时间数据传输所消耗的网络带宽。

参数属性

类型:UInt32
默认值:None
支持通配符:False
不显示:False

参数集

UNNAMED_PARAMETER_SET_2
Position:5
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

输入

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting

输出

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting