Add-DataGatewayCluster
Crée un cluster de passerelle de données une fois la passerelle installée sur un ordinateur
Syntaxe
Default (Par défaut)
Add-DataGatewayCluster
-RecoveryKey <SecureString>
-GatewayName <String>
[-RegionKey <String>]
[-OverwriteExistingGateway]
[<CommonParameters>]
Description
Crée un cluster de passerelle de données une fois la passerelle installée sur un ordinateur
Exemples
Exemple 1
PS C:\> Add-DataGatewayCluster -Name "MyNewGateway" -RecoveryKey (Read-Host "Enter Recovery Key" -AsSecureString)
Crée une passerelle nommée « MyNewGateway ».
Exemple 2
PS C:\> ConvertFrom-SecureString -SecureString (Read-Host "Enter Recovery Key" -AsSecureString) | Out-File -FilePath .\encryptedRecoveryKey.txt
PS C:\> $secureRecoveryKey = (cat .\encryptedRecoveryKey.txt | ConvertTo-SecureString)
PS C:\> Add-DataGatewayCluster -RecoveryKey $secureRecoveryKey -Name "MyNewGateway" -RegionKey brazilsouth
Crée une passerelle nommée « MyNewGateway » dans la région Brésil Sud. Vous pouvez stocker en toute sécurité la clé de récupération chiffrée dans un fichier et le transmettre à Add-DataGatewayCluster sans aucune interaction utilisateur.
Exemple 3
PS C:\> ConvertFrom-SecureString -SecureString (Read-Host "Enter Recovery Key" -AsSecureString) | Out-File -FilePath .\encryptedRecoveryKey.txt
PS C:\> $secureRecoveryKey = (cat .\encryptedRecoveryKey.txt | ConvertTo-SecureString)
PS C:\> Add-DataGatewayCluster -RecoveryKey $secureRecoveryKey -Name "MyNewGateway" -RegionKey brazilsouth -OverwriteExistingGateway
Crée une passerelle nommée « MyNewGateway » dans la région Brésil Sud et remplace la configuration de la passerelle existante sur cet ordinateur local et configure la nouvelle. Vous pouvez stocker en toute sécurité la clé de récupération chiffrée dans un fichier et le transmettre à Add-DataGatewayCluster sans aucune interaction utilisateur.
Paramètres
-GatewayName
Il s’agit du nom du cluster de passerelle qui sera créé. Elle ne peut pas entrer en conflit avec les passerelles existantes sur le même locataire.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Nom |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-OverwriteExistingGateway
Lorsque ce paramètre est défini, il remplace la configuration de passerelle existante sur l’ordinateur local et configure une nouvelle. La passerelle remplacée peut toujours être récupérée sur un autre ordinateur.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RecoveryKey
La clé de récupération est utilisée par la passerelle pour chiffrer/déchiffrer les informations d’identification locales. Cela est également réécrit pour restaurer la passerelle ou ajouter un nouveau membre au cluster de passerelle.
Propriétés du paramètre
| Type: | SecureString |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RegionKey
Ce paramètre indique la région Azure associée à votre passerelle. Lorsqu’une RegionKey n’est pas fournie, la région Power BI par défaut de votre locataire est utilisée.
Pour obtenir la liste des paramètres de région disponibles, exécutez l’applet de commande Get-DataGatewayRegion
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
None
Sorties
System.Void
Notes
Cette commande doit être exécutée avec des informations d’identification basées sur l’utilisateur.