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 支持具有中等影响的 WhatIf 和 Confirm 参数。 中等影响表示默认情况下,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