/// <summary>
/// Main entry point for handling a user operation
/// </summary>
/// <param name="portal">DevicePortal reference for communicating with the device.</param>
/// <param name="parameters">Parsed command line parameters.</param>
public static void HandleOperation(DevicePortal portal, ParameterHelper parameters)
{
if (parameters.HasFlag(ParameterHelper.HelpFlag))
{
Console.WriteLine(XblUserUsageMessage);
return;
}
string operationType = parameters.GetParameterValue("subop");
if (string.IsNullOrWhiteSpace(operationType))
{
Console.WriteLine("Missing subop parameter");
Console.WriteLine();
Console.WriteLine(XblUserUsageMessage);
return;
}
operationType = operationType.ToLowerInvariant();
if (operationType.Equals("list"))
{
Task <UserList> getUsers = portal.GetXboxLiveUsers();
getUsers.Wait();
Console.WriteLine(getUsers.Result);
}
else if (operationType.Equals("addsponsored"))
{
UserInfo user = new UserInfo();
user.SponsoredUser = true;
user.SignedIn = true;
UserList userList = new UserList();
userList.Add(user);
UpdateXboxLiveUsers(portal, userList);
}
else if (operationType.Equals("signin") || operationType.Equals("signout") || operationType.Equals("delete") || operationType.Equals("autosignin"))
{
UserInfo user = new UserInfo();
if (parameters.HasParameter("id"))
{
uint userId = 0;
if (!uint.TryParse(parameters.GetParameterValue("id"), out userId))
{
Console.WriteLine(string.Format("Failed to parse id to an unsigned integer: {0}", parameters.GetParameterValue("id")));
return;
}
user.UserId = userId;
}
else
{
user.EmailAddress = parameters.GetParameterValue("msa");
if (user.EmailAddress == null)
{
Console.WriteLine("Must provide either msa or id to this operation");
Console.WriteLine();
Console.WriteLine(XblUserUsageMessage);
return;
}
}
if (operationType.Equals("signin"))
{
// Optional password (only used on first signin)
user.Password = parameters.GetParameterValue("msapwd");
user.SignedIn = true;
}
else if (operationType.Equals("signout"))
{
user.SignedIn = false;
}
else if (operationType.Equals("delete"))
{
user.Delete = true;
}
else if (operationType.Equals("autosignin"))
{
if (parameters.HasFlag("on"))
{
user.AutoSignIn = true;
}
else if (parameters.HasFlag("off"))
{
user.AutoSignIn = false;
}
else
{
Console.WriteLine("autosignin operation requires the state (/on or /off).");
Console.WriteLine();
Console.WriteLine(XblUserUsageMessage);
return;
}
}
UserList userList = new UserList();
userList.Add(user);
UpdateXboxLiveUsers(portal, userList);
}
else
{
Console.WriteLine(string.Format("Unrecognized subop: {0}", operationType));
Console.WriteLine();
Console.WriteLine(XblUserUsageMessage);
return;
}
}
/// <summary>
/// Main entry point
/// </summary>
/// <param name="args">command line args</param>
public static void Main(string[] args)
{
ParameterHelper parameters = new ParameterHelper();
Program app = new Program();
string targetConsole = string.Empty;
try
{
parameters.ParseCommandLine(args);
OperationType operation = OperationType.None;
if (parameters.HasParameter(ParameterHelper.Operation))
{
operation = OperationStringToEnum(parameters.GetParameterValue("op"));
}
// Allow /ip: to still function, even though we've moved to /x: in the documentation.
if (parameters.HasParameter(ParameterHelper.IpOrHostnameOld) && !parameters.HasParameter(ParameterHelper.IpOrHostname))
{
targetConsole = parameters.GetParameterValue(ParameterHelper.IpOrHostnameOld);
}
else if (parameters.HasParameter(ParameterHelper.IpOrHostname))
{
targetConsole = parameters.GetParameterValue(ParameterHelper.IpOrHostname);
}
if (string.IsNullOrEmpty(targetConsole))
{
object regValue;
regValue = Microsoft.Win32.Registry.GetValue(DefaultConsoleRegkey, null, null);
if (regValue == null)
{
regValue = Microsoft.Win32.Registry.GetValue(DefaultXtfConsoleRegkey, null, null);
}
if (regValue is string)
{
targetConsole = regValue as string;
}
else
{
throw new Exception("No default console is currently set. Must provide an ip address or hostname to connect to: /x:<ip or hostname>.");
}
}
string finalConnectionAddress = string.Format("https://{0}:11443", targetConsole);
string userName = parameters.GetParameterValue(ParameterHelper.WdpUser);
string password = parameters.GetParameterValue(ParameterHelper.WdpPassword);
if (string.IsNullOrEmpty(userName) || string.IsNullOrEmpty(password))
{
try
{
// No creds were provided on the command line.
CredManager.RetrieveStoredCreds(targetConsole, ref userName, ref password);
}
catch (TypeLoadException)
{
// Windows 7 doesn't support credential storage so we'll get a TypeLoadException
throw new Exception("Credential storage is not supported on your PC. It requires Windows 8+ to run. Please provide the user and password parameters.");
}
}
else
{
try
{
// Creds were provided on the command line.
CredManager.UpdateStoredCreds(targetConsole, userName, password);
}
catch (TypeLoadException)
{
// Do nothing. We can't store these on Win7
}
}
X509Certificate2 cert = null;
IDevicePortalConnection connection = new DefaultDevicePortalConnection(finalConnectionAddress, userName, password);
DevicePortal portal = new DevicePortal(connection);
if (parameters.HasParameter(ParameterHelper.Cert))
{
string certFile = parameters.GetParameterValue(ParameterHelper.Cert);
try
{
cert = new X509Certificate2(certFile);
}
catch (Exception e)
{
throw new Exception(string.Format("Failed to read manual cert file {0}, {1}", certFile, e.Message), e);
}
}
// Add additional handling for untrusted certs.
portal.UnvalidatedCert += app.DoCertValidation;
// If a thumbprint is provided, use it for this connection. Otherwise check the registry.
if (parameters.HasParameter("thumbprint"))
{
app.AcceptedThumbprint = parameters.GetParameterValue("thumbprint");
}
else
{
object regValue;
regValue = Microsoft.Win32.Registry.GetValue(DefaultConsoleRegkey, targetConsole, null);
if (regValue is string)
{
app.AcceptedThumbprint = regValue as string;
}
}
Task connectTask = portal.Connect(updateConnection: false, manualCertificate: cert);
connectTask.Wait();
if (portal.ConnectionHttpStatusCode != HttpStatusCode.OK)
{
if (portal.ConnectionHttpStatusCode == HttpStatusCode.Unauthorized)
{
if (connection.Credentials == null)
{
Console.WriteLine("The WDP connection was rejected due to missing credentials.\n\nPlease provide the /user:<username> and /pwd:<pwd> parameters on your first call to WDP.");
}
else
{
Console.WriteLine("The WDP connection was rejected due to bad credentials.\n\nPlease check the /user:<username> and /pwd:<pwd> parameters.");
}
}
else if (!string.IsNullOrEmpty(portal.ConnectionFailedDescription))
{
Console.WriteLine(string.Format("Failed to connect to WDP (HTTP {0}) : {1}", (int)portal.ConnectionHttpStatusCode, portal.ConnectionFailedDescription));
}
else
{
Console.WriteLine("Failed to connect to WDP for unknown reason.");
}
}
else
{
// If the operation is more than a couple lines, it should
// live in its own file. These are arranged alphabetically
// for ease of use.
switch (operation)
{
case OperationType.AppOperation:
AppOperation.HandleOperation(portal, parameters);
break;
case OperationType.ConfigOperation:
ConfigOperation.HandleOperation(portal, parameters);
break;
case OperationType.ConnectOperation:
// User provided a new ip or hostname to set as the default.
if (parameters.HasParameter(ParameterHelper.IpOrHostname) || parameters.HasParameter(ParameterHelper.IpOrHostnameOld))
{
Microsoft.Win32.Registry.SetValue(DefaultConsoleRegkey, null, targetConsole);
Console.WriteLine("Default console set to {0}", targetConsole);
}
else
{
Console.WriteLine("Connected to Default console: {0}", targetConsole);
}
if (parameters.HasParameter("thumbprint"))
{
string thumbprint = parameters.GetParameterValue("thumbprint");
Microsoft.Win32.Registry.SetValue(DefaultConsoleRegkey, targetConsole, thumbprint);
Console.WriteLine("Thumbprint {0} saved for console with address {1}.", thumbprint, targetConsole);
}
break;
case OperationType.FiddlerOperation:
FiddlerOperation.HandleOperation(portal, parameters);
break;
case OperationType.FileOperation:
FileOperation.HandleOperation(portal, parameters);
break;
case OperationType.InfoOperation:
Console.WriteLine("OS version: " + portal.OperatingSystemVersion);
Console.WriteLine("Platform: " + portal.PlatformName + " (" + portal.Platform.ToString() + ")");
Task <string> getNameTask = portal.GetDeviceName();
getNameTask.Wait();
Console.WriteLine("Device name: " + getNameTask.Result);
break;
case OperationType.InstallOperation:
// Ensure we have an IP since SMB might need it for path generation.
parameters.AddParameter(ParameterHelper.IpOrHostname, targetConsole);
InstallOperation.HandleOperation(portal, parameters);
break;
case OperationType.ListProcessesOperation:
ListProcessesOperation.HandleOperation(portal, parameters);
break;
case OperationType.RebootOperation:
Task rebootTask = portal.Reboot();
rebootTask.Wait();
Console.WriteLine("Rebooting device.");
break;
case OperationType.SandboxOperation:
SandboxOperation.HandleOperation(portal, parameters);
break;
case OperationType.ScreenshotOperation:
ScreenshotOperation.HandleOperation(portal, parameters);
break;
case OperationType.SystemPerfOperation:
SystemPerfOperation.HandleOperation(portal, parameters);
break;
case OperationType.XblUserOperation:
UserOperation.HandleOperation(portal, parameters);
break;
default:
Console.WriteLine("Successfully connected to console but no operation was specified. \n" +
"Use the '/op:<operation type>' parameter to run a specified operation.");
Console.WriteLine();
Console.WriteLine(AvailableOperationsText);
break;
}
}
}
catch (Exception e)
{
Console.WriteLine(e.Message);
Console.WriteLine();
Console.WriteLine(GeneralUsageMessage);
}
// If a debugger is attached, don't close but instead loop here until
// closed.
while (Debugger.IsAttached)
{
Thread.Sleep(0);
}
}
/// <summary>
/// Main entry point for handling an install operation
/// </summary>
/// <param name="portal">DevicePortal reference for communicating with the device.</param>
/// <param name="parameters">Parsed command line parameters.</param>
public static void HandleOperation(DevicePortal portal, ParameterHelper parameters)
{
if (parameters.HasFlag(ParameterHelper.HelpFlag))
{
Console.WriteLine(XblInstallUsageMessage);
return;
}
InstallOperation operation = new InstallOperation(portal);
portal.AppInstallStatus += operation.AppInstallStatusHandler;
if (parameters.HasFlag(ParameterHelper.VerboseFlag))
{
operation.verbose = true;
}
List <string> dependencies = new List <string>();
// Build up the list of dependencies.
if (parameters.HasParameter("depend"))
{
dependencies.AddRange(parameters.GetParameterValue("depend").Split(';'));
}
string certificate = parameters.GetParameterValue("cer");
string appxFile = parameters.GetParameterValue("appx");
string folderPath = parameters.GetParameterValue("folder");
string registerPath = parameters.GetParameterValue("register");
try
{
if (!string.IsNullOrEmpty(appxFile))
{
operation.mreAppInstall.Reset();
Task installTask = portal.InstallApplication(null, appxFile, dependencies, certificate);
operation.mreAppInstall.WaitOne();
if (operation.installResults.Status == ApplicationInstallStatus.Completed)
{
Console.WriteLine("Install complete.");
}
else
{
Console.WriteLine("Install failed in phase {0}. {1}", operation.installResults.Phase, operation.installResults.Message);
}
}
else if (!string.IsNullOrEmpty(folderPath))
{
// Install all dependencies one at a time (loose folder doesn't handle dependencies well).
foreach (string dependency in dependencies)
{
operation.mreAppInstall.Reset();
Task installTask = portal.InstallApplication(null, dependency, new List <string>());
operation.mreAppInstall.WaitOne();
if (operation.installResults.Status != ApplicationInstallStatus.Completed)
{
Console.WriteLine("Deploy failed during dependency installation. {0}", operation.installResults.Message);
return;
}
}
if (!Directory.Exists(folderPath))
{
Console.WriteLine("Failed to find provided loose folder.");
Console.WriteLine();
Console.WriteLine(XblInstallUsageMessage);
return;
}
// Remove any trailing slash
if (folderPath.EndsWith("\\"))
{
folderPath = folderPath.Remove(folderPath.Length - 1);
}
string destinationFolderName = parameters.GetParameterValue("destfoldername");
if (string.IsNullOrEmpty(destinationFolderName))
{
// Get just the folder name
string folderName = folderPath.Substring(folderPath.LastIndexOf('\\') + 1);
destinationFolderName = folderName;
}
string transferType = parameters.GetParameterValue("transfer");
if (string.IsNullOrEmpty(transferType) || string.Equals(transferType, "smb", StringComparison.OrdinalIgnoreCase))
{
string shareName = Path.Combine("\\\\", parameters.GetParameterValue(ParameterHelper.IpOrHostname), "DevelopmentFiles");
string destinationFolder = Path.Combine(shareName, "LooseApps", destinationFolderName);
try
{
operation.CopyDirectory(folderPath, destinationFolder);
}
catch (IOException e)
{
if (e.HResult == ErrorLogonFailureHresult)
{
Task <SmbInfo> smbTask = portal.GetSmbShareInfo();
smbTask.Wait();
// Set the username/password for accessing the share.
NetworkShare.DisconnectFromShare(shareName, true);
int connected = NetworkShare.ConnectToShare(shareName, smbTask.Result.Username, smbTask.Result.Password);
if (connected != 0)
{
Console.WriteLine(string.Format("Failed to connect to the network share: {0}", connected));
return;
}
operation.CopyDirectory(folderPath, destinationFolder);
NetworkShare.DisconnectFromShare(shareName, false);
}
else
{
Console.WriteLine(string.Format("Unexpected exception encountered: {0}", e.Message));
return;
}
}
}
else if (string.Equals(transferType, "http", StringComparison.OrdinalIgnoreCase))
{
operation.UploadDirectoryOverHttp(folderPath, destinationFolderName);
}
else
{
Console.WriteLine(string.Format("Unexpected transfer type received: {0}. Expecting one of SMB or HTTP.", transferType));
return;
}
Task registerTask = portal.RegisterApplication(destinationFolderName);
registerTask.Wait();
Console.WriteLine("Install complete.");
}
else if (!string.IsNullOrEmpty(registerPath))
{
Task registerTask = portal.RegisterApplication(registerPath);
registerTask.Wait();
Console.WriteLine("Registration complete.");
}
else
{
Console.WriteLine("Must provide an appx package, loose folder, or path to register.");
Console.WriteLine();
Console.WriteLine(XblInstallUsageMessage);
return;
}
}
catch (AggregateException e)
{
if (e.InnerException is DevicePortalException)
{
DevicePortalException innerException = e.InnerException as DevicePortalException;
Console.WriteLine(string.Format("Exception encountered: {0}, hr = 0x{1:X} : {2}", innerException.StatusCode, innerException.HResult, innerException.Reason));
}
else if (e.InnerException is OperationCanceledException)
{
Console.WriteLine("The operation was cancelled.");
}
else
{
Console.WriteLine(string.Format("Unexpected exception encountered: {0}", e.Message));
}
return;
}
}