Share via

Set-OBMachineSetting

  • 参考
模块:
MSOnlineBackup

设置服务器的 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 密钥保管库中。

参数

-Confirm

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EncryptionPassphrase

设置用于加密备份数据的加密通行短语。

Type:SecureString
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-EndWorkHour

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

Type:TimeSpan
Position:4
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-KeyVaultUri

输入密钥保管库 URI 以安全地保存通行短语。 在指定的密钥保管库中创建一个新机密，用于保存通行短语。 需要指定建议) (PassphraseSaveLocation 或 KeyVaultUri 之一。

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-NonWorkHourBandwidth

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

Type:UInt32
Position:6
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoProxy

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

Type:SwitchParameter
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoThrottle

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

Type:SwitchParameter
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PassphraseSaveLocation

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

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProxyPassword

指定要用于代理设置的身份验证密码。

Type:SecureString
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProxyPort

指定要在代理服务器上使用的端口号。

Type:Int32
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ProxyServer

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

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ProxyUsername

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

Type:String
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SecurityPin

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

Type:String
Position:named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StartWorkHour

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

Type:TimeSpan
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WorkDay

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

Type:DayOfWeek[] {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday}
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WorkHourBandwidth

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

Type:UInt32
Position:5
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

输入

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting

输出

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting