Set-OBMachineSetting

Referencia

Módulo:: MSOnlineBackup

Establece un objeto OBMachineSetting para el servidor.

Syntax

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]

Description

El cmdlet Set-OBMachineSetting establece un objeto OBMachineSetting para el servidor que incluye la configuración del servidor proxy para acceder a Internet, la configuración de limitación de ancho de banda de red y la frase de contraseña de cifrado necesaria para descifrar los archivos durante la recuperación en otro servidor.

Este cmdlet admite parámetros WhatIf y Confirm con un impacto medio. El impacto medio significa que el cmdlet no solicitará al usuario la confirmación de forma predeterminada. El parámetro WhatIf proporciona una descripción detallada de lo que hace el cmdlet sin realizar ninguna operación. El parámetro Confirm especifica si el cmdlet debe solicitar al usuario. El uso de -Confirm:$FALSE invalidará el símbolo del sistema.

Para usar cmdlets de Microsoft Azure Backup, el usuario debe ser administrador en el equipo protegido.

Ejemplos

EJEMPLO 1

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

En este ejemplo se establece la frase de contraseña de cifrado para un equipo.

EJEMPLO 2

$spwd = ConvertTo-SecureString -String Notag00pa55word -AsPlainText -Force



Set-OBMachineSetting -ProxyServer http://proxycontoso.com -ProxyPort <your proxy port> -ProxyUsername contoso\johnj99 -ProxyPassword $spwd

En este ejemplo se establece la configuración de proxy para un servidor.

EJEMPLO 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)

En este ejemplo se establece la configuración de limitación.

EJEMPLO 4

Set-OBMachineSetting -NoThrottle

En este ejemplo se especifica que este servidor no usará la limitación de ancho de banda de red.

EJEMPLO 5

Set-OBMachineSetting -NoProxy

En este ejemplo se especifica que este servidor no usa una configuración de servidor proxy única.

EJEMPLO 6

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

En este ejemplo se registra un servidor con la frase de contraseña especificada y se guarda en la ubicación proporcionada.

EJEMPLO 7

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

En este ejemplo se registra un servidor con la frase de contraseña especificada y se guarda en Azure Key Vault.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-EncryptionPassphrase

Establece la frase de contraseña de cifrado que se usará para cifrar los datos de copia de seguridad.

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

-EndWorkHour

Especifica la hora que finaliza el intervalo de horas de trabajo.

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

-KeyVaultUri

Escriba un URI de Key Vault para guardar la frase de contraseña de forma segura. Se crea un nuevo secreto en el almacén de claves especificado para guardar la frase de contraseña. Debe especificarse una de passphraseSaveLocation o KeyVaultUri (recomendado).

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

-NonWorkHourBandwidth

Especifica la configuración de limitación de ancho de banda que se va a usar para limitar el ancho de banda de red consumido por las transferencias de datos durante horas que no son de trabajo.

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

-NoProxy

Especifica que la configuración única del servidor proxy no se usará para las copias de seguridad en línea.

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

-NoThrottle

Especifica que la limitación de red no se usa con copias de seguridad en línea. Las transferencias de datos de los elementos de copia de seguridad del servidor local al servidor de Microsoft Azure Backup usarán el ancho de banda según sea necesario.

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

-PassphraseSaveLocation

Escriba una ubicación de red o una carpeta donde se pueda guardar la frase de contraseña. No se recomienda guardar la frase de contraseña en la máquina que se está protegiendo. Microsoft no puede recuperar los datos de copia de seguridad si se pierde la frase de contraseña. Debe especificarse una de passphraseSaveLocation o KeyVaultUri (recomendado).

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

-ProxyPassword

Especifica la contraseña de autenticación que se usará para la configuración de proxy.

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

-ProxyPort

Especifica el número de puerto que se va a usar en el servidor proxy.

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

-ProxyServer

Especifica el servidor proxy que se va a usar al conectarse al servidor de Microsoft Azure Backup.

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

-ProxyUsername

Especifica el nombre de usuario que se va a usar para la autenticación del servidor proxy.

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

-SecurityPin

El pin de seguridad es necesario si cambia la frase de contraseña y la configuración de seguridad híbrida está activada para el almacén de Recovery Services. Para generar un pin de seguridad, seleccione Generar en Configuración > Propiedades > PIN de seguridad en la sección Almacén de Recovery Services del Azure Portal.

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

-StartWorkHour

Especifica la hora que inicia el intervalo de horas laborables.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

-WorkDay

Especifica la matriz de días laborables mediante las variables del sistema [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

Especifica la configuración de limitación de ancho de banda que se usará para limitar el ancho de banda de red consumido por las transferencias de datos durante las horas de trabajo.

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

Entradas

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting

Salidas