Compartir a través de

Set-OBMachineSetting

Módulo:
MSOnlineBackup Module

Establece un objeto OBMachineSetting para el servidor.

Sintaxis

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]

Description

El Set-OBMachineSetting cmdlet 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 del 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 los 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 preguntar al usuario. El uso -Confirm:$FALSE anulará el mensaje.

Para usar cmdlets de Copia de seguridad de Microsoft Azure, el usuario debe ser administrador del 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
$setOBMachineSettingSplat = @{
    ProxyServer   = 'http://proxycontoso.com'
    ProxyPort     = '<your proxy port>'
    ProxyUsername = 'contoso\johnj99'
    ProxyPassword = $spwd
}
Set-OBMachineSetting @setOBMachineSettingSplat

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

EJEMPLO 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

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 utilizará la limitación del ancho de banda de red.

EJEMPLO 5

Set-OBMachineSetting -NoProxy

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

EJEMPLO 6

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

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

EJEMPLO 7

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

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 pide confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-EncryptionPassphrase

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

Propiedades del parámetro

Tipo:SecureString
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UNNAMED_PARAMETER_SET_1
Posición:2
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-EndWorkHour

Especifica la hora que finaliza el intervalo de horas laborables.

Propiedades del parámetro

Tipo:TimeSpan
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UNNAMED_PARAMETER_SET_2
Posición:4
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes: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. Se debe especificar uno de los valores PassphraseSaveLocation o KeyVaultUri (recomendado).

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:3
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-NonWorkHourBandwidth

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

Propiedades del parámetro

Tipo:UInt32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UNNAMED_PARAMETER_SET_2
Posición:6
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-NoProxy

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UNNAMED_PARAMETER_SET_3
Posición:2
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-NoThrottle

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UNNAMED_PARAMETER_SET_4
Posición:2
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PassphraseSaveLocation

Introduzca una ubicación de red o una carpeta en la que se pueda guardar la frase de contraseña. No se recomienda guardar la frase de contraseña en el equipo que se está protegiendo. Microsoft no puede recuperar los datos de copia de seguridad si se pierde la frase de contraseña. Se debe especificar uno de los valores PassphraseSaveLocation o KeyVaultUri (recomendado).

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:2
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ProxyPassword

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

Propiedades del parámetro

Tipo:SecureString
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UNNAMED_PARAMETER_SET_5
Posición:5
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ProxyPort

Especifica el número de puerto que se utilizará en el servidor proxy.

Propiedades del parámetro

Tipo:Int32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UNNAMED_PARAMETER_SET_5
Posición:3
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-ProxyServer

Especifica el servidor proxy que se usará al conectarse al servidor de Copias de seguridad de Microsoft Azure.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UNNAMED_PARAMETER_SET_5
Posición:2
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ProxyUsername

Especifica el nombre de usuario que se utilizará para la autenticación del servidor proxy.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UNNAMED_PARAMETER_SET_5
Posición:4
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-SecurityPin

El pin de seguridad es necesario si va a cambiar 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 seguridaden la sección Almacén de Recovery Services de Azure Portal.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:3
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-StartWorkHour

Especifica la hora a la que se inicia el intervalo de horas laborables.

Propiedades del parámetro

Tipo:TimeSpan
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UNNAMED_PARAMETER_SET_2
Posición:3
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WorkDay

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

Propiedades del parámetro

Tipo:

DayOfWeek[]

Valor predeterminado:None
Valores aceptados:Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UNNAMED_PARAMETER_SET_2
Posición:2
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:UInt32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

UNNAMED_PARAMETER_SET_2
Posición:5
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

Entradas

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting

Salidas

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting