Summary
This cmdlet returns info about Octopus Targets (Tentacles, cloud regions, Offline deployment targets, SHH)
Parameters
Name | DataType | Description |
---|---|---|
MachineName | String[] | Name of the Machine to filter by |
EnvironmentName | String[] | Name of the Environment to filter by |
URL | String[] | Target URI to filter by |
CommunicationStyle | String | Target communication style to filter by |
ResourceOnly | Switch | If set to TRUE the cmdlet will return the basic Octopur resource. If not set or set to FALSE, the cmdlet will return a human friendly Octoposh output object |
Syntax
Get-OctopusMachine [[-MachineName] <string[]>] [-ResourceOnly <SwitchParameter>] [<CommonParameters>]
Get-OctopusMachine [-EnvironmentName <string[]>] [-ResourceOnly <SwitchParameter>] [<CommonParameters>]
Get-OctopusMachine [-ResourceOnly <SwitchParameter>] [-URL <string[]>] [<CommonParameters>]
Get-OctopusMachine [-CommunicationStyle <string>] [-ResourceOnly <SwitchParameter>] [<CommonParameters>]
Examples
EXAMPLE 1
Gets the machine with the name "Database_Prod"
Get-OctopusMachine -name "Database_Prod"
EXAMPLE 2
Gets all the machines which name is like "*_Prod"
Get-OctopusMachine -name "*_Prod"
EXAMPLE 3
Gets all the machines on the environments "Staging","UAT"
Get-OctopusMachine -EnvironmentName "Staging","UAT""
EXAMPLE 4
Gets all the machines with the string "*:10933" at the end of the URL
Get-OctopusMachine -URL "*:10933"
EXAMPLE 5
Gets all the machines registered in "Listening" mode. "Polling" is also a valid value
PS Get-OctopusMachine -Mode Listening