Partager via

Set-OBMachineSetting

  • Référence
Module:
MSOnlineBackup

Définit un objet OBMachineSetting pour le serveur.

Syntaxe

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

L’applet de commande set-OBMachineSetting définit un objet OBMachineSetting pour le serveur qui inclut les paramètres du serveur proxy pour accéder à Internet, les paramètres de limitation de bande passante réseau et la phrase secrète de chiffrement requise pour déchiffrer les fichiers pendant la récupération sur un autre serveur.

Cette applet de commande prend en charge les paramètres WhatIf et Confirm avec un impact moyen. L’impact moyen signifie que l’applet de commande n’invite pas l’utilisateur à confirmer par défaut. Le paramètre WhatIf fournit une description détaillée de ce que fait l’applet de commande sans effectuer d’opération. Le paramètre Confirm spécifie si l’applet de commande doit inviter l’utilisateur. L’utilisation de -Confirm :$FALSE remplace l’invite.

Pour utiliser les applets de commande Microsoft Azure Backup, l’utilisateur doit être administrateur sur l’ordinateur protégé.

Exemples

EXEMPLE 1

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

Cet exemple montre comment définir la phrase secrète de chiffrement pour un ordinateur.

EXEMPLE 2

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



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

Cet exemple montre comment définir les paramètres de proxy pour un serveur.

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

Cet exemple montre comment définir les paramètres de limitation.

EXEMPLE 4

Set-OBMachineSetting -NoThrottle

Cet exemple spécifie que la limitation de bande passante réseau ne sera pas utilisée par ce serveur.

EXEMPLE 5

Set-OBMachineSetting -NoProxy

Cet exemple spécifie que ce serveur n’utilise pas de configuration de serveur proxy unique.

EXEMPLE 6

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

Cet exemple enregistre un serveur avec la phrase secrète donnée et l’enregistre à l’emplacement fourni.

EXEMPLE 7

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

Cet exemple enregistre un serveur avec la phrase secrète donnée et l’enregistre dans Azure Key Vault.

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EncryptionPassphrase

Définit la phrase secrète de chiffrement à utiliser pour chiffrer les données sauvegardées.

Type:SecureString
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-EndWorkHour

Spécifie l’heure qui termine la plage d’heures de travail.

Type:TimeSpan
Position:4
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-KeyVaultUri

Entrez un URI Key Vault pour enregistrer la phrase secrète en toute sécurité. Un nouveau secret est créé dans le coffre de clés spécifié pour enregistrer la phrase secrète. L’une des phrases secrètesSaveLocation ou KeyVaultUri (recommandé) doit être spécifiée.

Type:String
Position:3
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-NonWorkHourBandwidth

Spécifie le paramètre de limitation de bande passante à utiliser pour limiter la bande passante réseau consommée par les transferts de données pendant les heures de travail.

Type:UInt32
Position:6
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-NoProxy

Spécifie que les paramètres de serveur proxy uniques ne doivent pas être utilisés pour les sauvegardes en ligne.

Type:SwitchParameter
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NoThrottle

Spécifie que la limitation du réseau n’est pas utilisée avec les sauvegardes en ligne. Les transferts de données d’éléments sauvegardés du serveur local vers le serveur de sauvegarde Microsoft Azure utilisent la bande passante si nécessaire.

Type:SwitchParameter
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PassphraseSaveLocation

Entrez un emplacement réseau ou un dossier dans lequel la phrase secrète peut être enregistrée. L’enregistrement de la phrase secrète sur la machine protégée n’est pas recommandé. Microsoft ne peut pas récupérer les données de sauvegarde si la phrase secrète est perdue. L’une des phrases secrètesSaveLocation ou KeyVaultUri (recommandé) doit être spécifiée.

Type:String
Position:2
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ProxyPassword

Spécifie le mot de passe d’authentification à utiliser pour le paramètre proxy.

Type:SecureString
Position:5
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ProxyPort

Spécifie le numéro de port à utiliser sur le serveur proxy.

Type:Int32
Position:3
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ProxyServer

Spécifie le serveur proxy à utiliser lors de la connexion au serveur de sauvegarde Microsoft Azure.

Type:String
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ProxyUsername

Spécifie le nom d’utilisateur à utiliser pour l’authentification du serveur proxy.

Type:String
Position:4
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SecurityPin

La broche de sécurité est nécessaire si vous modifiez la phrase secrète et que le paramètre de sécurité hybride est activé pour le coffre Recovery Services. Vous devez générer une broche de sécurité en sélectionnant Générer sous Paramètres > Propriétés > code confidentiel de sécurité dans la section coffre Recovery Services du portail Azure.

Type:String
Position:named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-StartWorkHour

Spécifie l’heure qui démarre la plage d’heures de travail.

Type:TimeSpan
Position:3
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WorkDay

Spécifie le tableau des jours de travail à l’aide de [DayOfWeek] variables système.

Type:DayOfWeek[] {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday}
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-WorkHourBandwidth

Spécifie le paramètre de limitation de bande passante à utiliser pour limiter la bande passante réseau consommée par les transferts de données pendant les heures de travail.

Type:UInt32
Position:5
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting

Sorties

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting