Connect-AzConnectedMachine
API per registrare un nuovo computer e quindi creare una risorsa rilevata in ARM
Sintassi
Connect-AzConnectedMachine
[-ResourceGroupName] <String>
[[-SubscriptionId] <String>]
[[-Name] <String>]
[-Location] <String>
[[-PSSession] <PSSession[]>]
[[-Tag] <Hashtable>]
[[-DefaultProfile] <PSObject>]
[[-Proxy] <Uri>]
[<CommonParameters>]
Descrizione
API per registrare un nuovo computer e quindi creare una risorsa rilevata in ARM
Esempio
Esempio 1: Esegue l'onboarding del computer in uso come computer connesso
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
Esegue l'onboarding del computer in uso come computer connesso.
Esempio 2: Onboarding di un computer remoto come dispositivo connesso
$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
Esegue l'onboarding di un computer remoto come dispositivo connesso usando la comunicazione remota di PowerShell. Nota: al momento è supportato solo Windows come destinazione.
Parametri
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.
Tipo: | PSObject |
Alias: | AzureRMContext, AzureCredential |
Posizione: | 5 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Location
Percorso dell'oggetto ConnectedMachine creato.
Tipo: | String |
Posizione: | 3 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Name
Nome che verrà utilizzato per il computer. Il nome host viene usato per impostazione predefinita.
Tipo: | String |
Posizione: | 4 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Proxy
URI per il server proxy da usare
Tipo: | Uri |
Posizione: | 8 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-PSSession
Se specificato, il comando che esegue l'onboarding dei computer in Azure verrà eseguito all'interno di ogni sessione PSSession. NOTA: funziona solo in Windows per il momento.
Tipo: | PSSession[] |
Alias: | Session |
Posizione: | 6 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-ResourceGroupName
Nome del gruppo di risorse a cui si vuole aggiungere il computer.
Tipo: | String |
Posizione: | 1 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-SubscriptionId
ID della sottoscrizione a cui si vuole aggiungere il computer.
Tipo: | String |
Posizione: | 2 |
Valore predefinito: | (Get-AzContext).Subscription.Id |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Tag
Tag di risorsa.
Tipo: | Hashtable |
Posizione: | 7 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |