Get-AzConnectedMachine
Retrieves information about the model view or the instance view of a hybrid machine.
Syntax
List1 (Default)
Get-AzConnectedMachine
[-SubscriptionId <String[]>]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Get
Get-AzConnectedMachine
-Name <String>
-ResourceGroupName <String>
[-SubscriptionId <String[]>]
[-Expand <String>]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
List
Get-AzConnectedMachine
-ResourceGroupName <String>
[-SubscriptionId <String[]>]
[-Expand <String>]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
Description
Retrieves information about the model view or the instance view of a hybrid machine.
Examples
Example 1: List all connected machines in a subscription
Get-AzConnectedMachine -SubscriptionId ********-****-****-****-**********
Name Location OSName Status ProvisioningState
---- -------- ------ ------ -----------------
winwestus2_1 westus2 windows Connected Succeeded
linwestus2_1 westus2 linux Connected Succeeded
winwestus2_2 westus2 windows Connected Succeeded
winwestus2_3 westus2 windows Connected Succeeded
Lists all connected machines in a subscription. If subscription isn't specified, it will use the subscription from your current Azure PowerShell context.
Example 2: List all connected machines in a resource group
Get-AzConnectedMachine -ResourceGroupName contoso-connected-machines
Name Location OSName Status ProvisioningState
---- -------- ------ ------ -----------------
winwestus2_2 westus2 windows Connected Succeeded
winwestus2_3 westus2 windows Connected Succeeded
List all connected machines in a resource group.
Example 3: Get a connected machine in a resource group by name
Get-AzConnectedMachine -ResourceGroupName contoso-connected-machines -Name winwestus2_1
Name Location OSName Status ProvisioningState
---- -------- ------ ------ -----------------
winwestus2_1 westus2 windows Connected Succeeded
Get a connected machine in a resource group by name.
Parameters
-DefaultProfile
The DefaultProfile parameter is not functional. Use the SubscriptionId parameter when available if executing the cmdlet against a different subscription.
Parameter properties
| Type: | PSObject |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | AzureRMContext, AzureCredential |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Expand
The expand expression to apply on the operation.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Get
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
List
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Name
The name of the hybrid machine.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | MachineName |
Parameter sets
Get
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ResourceGroupName
The name of the resource group. The name is case insensitive.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
Get
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
List
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-SubscriptionId
The ID of the target subscription.
Parameter properties
| Type: | String[] |
| Default value: | (Get-AzContext).Subscription.Id |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
