Compartir a través de

Set-OBMachineSetting

  • Referencia
Módulo:
MSOnlineBackup

Establece un objeto OBMachineSetting para el servidor.

Sintaxis

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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EncryptionPassphrase

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

Tipo:SecureString
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-EndWorkHour

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

Tipo:TimeSpan
Posición:4
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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).

Tipo:String
Posición:3
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:UInt32
Posición:6
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-NoProxy

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

Tipo:SwitchParameter
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:SwitchParameter
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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).

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ProxyPassword

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

Tipo:SecureString
Posición:5
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ProxyPort

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

Tipo:Int32
Posición:3
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ProxyServer

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

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ProxyUsername

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

Tipo:String
Posición:4
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:String
Posición:named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-StartWorkHour

Especifica la hora que inicia el intervalo de horas laborables.

Tipo:TimeSpan
Posición:3
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WorkDay

Especifica la matriz de días laborables mediante las variables del sistema [DayOfWeek].

Tipo:DayOfWeek[] {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday}
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:UInt32
Posición:5
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting

Salidas

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting