Set-OBMachineSetting
设置服务器的 OBMachineSetting 对象。
语法
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] 说明
Set-OBMachineSetting cmdlet 为服务器设置一个 OBMachineSetting 对象，其中包括用于访问 Internet 的代理服务器设置、网络带宽限制设置以及恢复到另一个服务器期间解密文件所需的加密通行短语。
此 cmdlet 支持具有中等影响的 WhatIf 和 Confirm 参数。 中等影响表示 cmdlet 默认情况下不会提示用户进行确认。 WhatIf 参数提供 cmdlet 不执行任何操作的详细描述。 Confirm 参数指定 cmdlet 是否应提示用户。 使用 -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
Set-OBMachineSetting -ProxyServer http://proxycontoso.com -ProxyPort <your proxy port> -ProxyUsername contoso\johnj99 -ProxyPassword $spwd此示例设置服务器的代理设置。
示例 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)此示例设置限制设置。
示例 4
Set-OBMachineSetting -NoThrottle此示例指定此服务器不会使用此网络带宽限制。
示例 5
Set-OBMachineSetting -NoProxy此示例指定此服务器不使用唯一的代理服务器配置。
示例 6
$spwd = ConvertTo-SecureString -String abcdefgh123456000345 -AsPlainText -Force
Set-OBMachineSetting -EncryptionPassphrase $spwd -SecurityPIN 123456 -PassphraseSaveLocation "C:\Users\myuser\MyFolder \Desktop\passphrases\"此示例向给定的通行短语注册服务器，并将其保存在提供的位置。
示例 7
$spwd = ConvertTo-SecureString -String abcdefgh123456000345 -AsPlainText -Force
Set-OBMachineSetting -EncryptionPassphrase $spwd -SecurityPIN 123456 -KeyVaultUri "https://mykeyvault.vault.azure.net/"此示例向给定的通行短语注册服务器，并将其保存在 Azure Key Vault 中。
参数
-Confirm
在运行 cmdlet 之前，提示你进行确认。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EncryptionPassphrase
设置用于加密备份数据的加密通行短语。
| 类型: | SecureString |
| Position: | 2 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-EndWorkHour
指定结束工作时间范围的小时。
| 类型: | TimeSpan |
| Position: | 4 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-KeyVaultUri
输入 Key Vault URI 以安全地保存通行短语。 在指定的密钥保管库中创建一个新机密，用于保存通行短语。 需要指定 PassphraseSaveLocation 或 KeyVaultUri（推荐）之一。
| 类型: | String |
| Position: | 3 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-NonWorkHourBandwidth
指定用于限制非工作时间数据传输使用的网络带宽限制设置。
| 类型: | UInt32 |
| Position: | 6 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-NoProxy
指定不用于联机备份的唯一代理服务器设置。
| 类型: | SwitchParameter |
| Position: | 2 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-NoThrottle
指定网络限制不用于联机备份。 从本地服务器到 Microsoft Azure 备份服务器的备份项的数据传输将根据需要使用带宽。
| 类型: | SwitchParameter |
| Position: | 2 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-PassphraseSaveLocation
输入可以保存通行短语的网络位置或文件夹。 不建议在受保护的计算机中保存通行短语。 如果密码丢失，Microsoft无法恢复备份数据。 需要指定 PassphraseSaveLocation 或 KeyVaultUri（推荐）之一。
| 类型: | String |
| Position: | 2 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-ProxyPassword
指定要用于代理设置的身份验证密码。
| 类型: | SecureString |
| Position: | 5 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-ProxyPort
指定要在代理服务器上使用的端口号。
| 类型: | Int32 |
| Position: | 3 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-ProxyServer
指定连接到 Microsoft Azure 备份服务器时要使用的代理服务器。
| 类型: | String |
| Position: | 2 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-ProxyUsername
指定要用于代理服务器身份验证的用户名。
| 类型: | String |
| Position: | 4 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-SecurityPin
如果要更改通行短语，并且已为恢复服务保管库启用混合安全设置，则必须使用安全引脚。 必须在 Azure 门户的“恢复服务保管库”部分的“设置”下选择“生成”> 属性 > 安全 PIN 来生成安全引脚。
| 类型: | String |
| Position: | named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-StartWorkHour
指定开始工作时间范围的小时。
| 类型: | TimeSpan |
| Position: | 3 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | False |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WorkDay
使用 using [DayOfWeek] 系统变量指定工作日数组。
| 类型: | DayOfWeek[] {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday} |
| Position: | 2 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-WorkHourBandwidth
指定用于限制工作时间数据传输使用的网络带宽限制设置。
| 类型: | UInt32 |
| Position: | 5 |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
输入
Microsoft.Internal.CloudBackup.Commands.OBMachineSetting
输出
Microsoft.Internal.CloudBackup.Commands.OBMachineSetting