Partager via

Set-OBMachineSetting

  • Référence
Module:
MSOnlineBackup

Définit un objet OBMachineSetting pour le serveur.

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

L’applet de commande Set-OBMachineSetting définit un objet OBMachineSetting pour le serveur qui inclut les paramètres de 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 Sauvegarde Azure, 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 proxy d’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 une 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 inscrit 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 inscrit un serveur avec la phrase secrète donnée et l’enregistre dans Azure Key Vault.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-EncryptionPassphrase

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

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

-EndWorkHour

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

Type:TimeSpan
Position:4
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 passphraseSaveLocation ou KeyVaultUri (recommandé) doit être spécifiée.

Type:String
Position:3
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoThrottle

Spécifie que la limitation 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 Microsoft Sauvegarde Azure utiliseront la bande passante si nécessaire.

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

-PassphraseSaveLocation

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

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

-ProxyPassword

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

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

-ProxyPort

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

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

-ProxyServer

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

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

-ProxyUsername

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

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

-SecurityPin

Une broche de sécurité est nécessaire si vous modifiez la phrase secrète et si 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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-StartWorkHour

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

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

-WorkDay

Spécifie le tableau de jours de travail à l’aide des variables système [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

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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entrées

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting

Sorties

Microsoft.Internal.CloudBackup.Commands.OBMachineSetting