Connect-AzConnectedMachine
API pour inscrire une nouvelle machine et ainsi créer une ressource suivie dans ARM
Syntaxe
Connect-AzConnectedMachine
[-ResourceGroupName] <String>
[[-SubscriptionId] <String>]
[[-Name] <String>]
[-Location] <String>
[[-PSSession] <PSSession[]>]
[[-Tag] <Hashtable>]
[[-DefaultProfile] <PSObject>]
[[-Proxy] <Uri>]
[<CommonParameters>]
Description
API pour inscrire une nouvelle machine et ainsi créer une ressource suivie dans ARM
Exemples
Exemple 1 : Intègre la machine sur laquelle vous êtes connecté
Connect-AzConnectedMachine -ResourceGroupName contoso-connected-machines -Name linux_eastus1_1 -Location eastus
< truncated output of installing the azcmagent >
time="2020-08-07T13:13:25-07:00" level=info msg="Onboarding Machine. It usually takes a few minutes to complete. Sometimes it may take longer depending on network and server load status."
time="2020-08-07T13:13:25-07:00" level=info msg="Check network connectivity to all endpoints..."
time="2020-08-07T13:13:29-07:00" level=info msg="All endpoints are available... continue onboarding"
time="2020-08-07T13:13:50-07:00" level=info msg="Successfully Onboarded Resource to Azure" VM Id=********-****-****-****-**********
Name Location OSName Status ProvisioningState
---- -------- ------ ------ -----------------
linux_eastus1_1 eastus linux Connected Succeeded
Intègre la machine sur laquelle vous êtes connecté.
Exemple 2 : Intégrer un ordinateur distant en tant qu’appareil connecté
$session = Connect-PSSession -ComputerName WINBOX
Connect-AzConnectedMachine -ResourceGroupName contoso-rg -Name win_eastus1_1 -Location eastus -PSSession $session
< truncated output of installing the azcmagent >
time="2020-08-07T13:13:25-07:00" level=info msg="Onboarding Machine. It usually takes a few minutes to complete. Sometimes it may take longer depending on network and server load status."
time="2020-08-07T13:13:25-07:00" level=info msg="Check network connectivity to all endpoints..."
time="2020-08-07T13:13:29-07:00" level=info msg="All endpoints are available... continue onboarding"
time="2020-08-07T13:13:50-07:00" level=info msg="Successfully Onboarded Resource to Azure" VM Id=********-****-****-****-**********
Name Location OSName Status ProvisioningState
---- -------- ------ ------ -----------------
win_eastus1_1 eastus windows Connected Succeeded
Intègre un ordinateur distant en tant qu’appareil connecté à l’aide de la communication à distance PowerShell. Remarque : seul Windows comme cible est pris en charge pour l’instant.
Paramètres
-DefaultProfile
Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.
Type: | PSObject |
Alias: | AzureRMContext, AzureCredential |
Position: | 5 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Location
Emplacement de l’objet ConnectedMachine créé.
Type: | String |
Position: | 3 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Name
Nom qui sera utilisé pour cet ordinateur. Le nom d’hôte est utilisé par défaut.
Type: | String |
Position: | 4 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Proxy
URI du serveur proxy à utiliser
Type: | Uri |
Position: | 8 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-PSSession
Quand elle est spécifiée, la commande qui intègre des machines à Azure est exécutée dans chaque session PSSession. REMARQUE : Cela fonctionne uniquement sur Windows pour le moment.
Type: | PSSession[] |
Alias: | Session |
Position: | 6 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-ResourceGroupName
Nom du groupe de ressources auquel vous souhaitez ajouter l’ordinateur.
Type: | String |
Position: | 1 |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-SubscriptionId
ID de l’abonnement auquel vous souhaitez ajouter la machine.
Type: | String |
Position: | 2 |
Valeur par défaut: | (Get-AzContext).Subscription.Id |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Tag
Balises de ressource.
Type: | Hashtable |
Position: | 7 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |