Process.MachineName Eigenschaft

Definition

Ruft den Namen des Computers ab, auf dem der zugeordnete Prozess ausgeführt wird.Gets the name of the computer the associated process is running on.

public:
 property System::String ^ MachineName { System::String ^ get(); };
public string MachineName { get; }
[System.ComponentModel.Browsable(false)]
public string MachineName { get; }
member this.MachineName : string
[<System.ComponentModel.Browsable(false)>]
member this.MachineName : string
Public ReadOnly Property MachineName As String

Eigenschaftswert

String

Der Name des Computers, auf dem der zugeordnete Prozess ausgeführt wird.The name of the computer that the associated process is running on.

Attribute

Ausnahmen

Diesem Process-Objekt ist kein Prozess zugeordnet.There is no process associated with this Process object.

Beispiele

Wenn Sie das folgende Beispiel verwenden möchten, müssen Sie zunächst mindestens eine Instanz von Notepad auf einem Remote Computer starten.To use the following example you must first start at least one instance of Notepad on a remote computer. Im Beispiel wird der Name des Remote Computers angefordert, auf dem der Editor ausgeführt wird, und anschließend werden die ProcessName entsprechenden Id Eigenschaften, und MachineName für jede Instanz angezeigt.The example requests the name of the remote computer on which Notepad is running, and then displays the respective ProcessName, Id, and MachineName properties for each instance.

using System;
using System.Diagnostics;

class GetProcessesByNameClass
{
    public static void Main(string[] args)
    {
        Console.WriteLine("Create notepad processes on remote computer");
        Console.Write("Enter remote computer name : ");
        string remoteMachineName = Console.ReadLine();

        if (remoteMachineName == null)
        {
            // Prepend a new line to prevent it from being on the same line as the prompt.
            Console.WriteLine(Environment.NewLine + "You have to enter a remote computer name.");
            return;
        }

        try
        {
            // Get all notepad processess into Process array.
            Process[] myProcesses = Process.GetProcessesByName("notepad", remoteMachineName);

            if (myProcesses.Length == 0)
                Console.WriteLine("Could not find notepad processes on remote computer.");

            foreach (Process myProcess in myProcesses)
            {
                Console.WriteLine(
                    $"Process Name : {myProcess.ProcessName}\n" +
                    $"Process ID   : {myProcess.Id}\n" +
                    $"MachineName  : {myProcess.MachineName}");
            }
        }
        catch (ArgumentException)
        {
            Console.WriteLine($"The value \'{remoteMachineName}\' is an invalid remote computer name.");
        }
        catch (InvalidOperationException)
        {
            Console.WriteLine("Unable to get process information on the remote computer.");
        }
        catch (PlatformNotSupportedException)
        {
            Console.WriteLine(
                "Finding notepad processes on remote computers " +
                "is not supported on this operating system.");
        }
    }
}
Imports System.Diagnostics

Class GetProcessesByNameClass

    'Entry point which delegates to C-style main Private Function
    Public Overloads Shared Sub Main()
        Main(Environment.GetCommandLineArgs())
    End Sub

    Public Overloads Shared Sub Main(ByVal args() As String)
        Console.WriteLine("Create notepad processes on remote computer")
        Console.Write("Enter remote computer name : ")
        Dim remoteMachineName As String = Console.ReadLine()

        If remoteMachineName Is Nothing Then
            ' Prepend a new line to prevent it from being on the same line as the prompt.
            Console.WriteLine(Environment.NewLine + "You have to enter a remote computer name.")
            Return
        End If

        Try
            ' Get all notepad processess into Process array.
            Dim myProcesses As Process() = Process.GetProcessesByName _
                                                ("notepad", remoteMachineName)
            If myProcesses.Length = 0 Then
                Console.WriteLine("Could not find notepad processes on remote computer.")
            End If
            Dim myProcess As Process
            For Each myProcess In myProcesses
                Console.WriteLine("Process Name : " & myProcess.ProcessName &
                            "  Process ID : " & myProcess.Id &
                            "  MachineName : " & myProcess.MachineName)
            Next myProcess
        Catch e As ArgumentException
            Console.WriteLine("The value '" & remoteMachineName & "' is an invalid remote computer name.")
        Catch e As PlatformNotSupportedException
            Console.WriteLine(
                "Finding notepad processes on remote computers " &
                "is not supported on this operating system.")
        Catch e As InvalidOperationException
            Console.WriteLine("Unable to get process information on the remote computer.")
        End Try
    End Sub
End Class

Hinweise

Sie können statistische Daten und Prozessinformationen für Prozesse anzeigen, die auf Remote Computern ausgeführt Start werden, Sie können jedoch nicht, CloseMainWindow oder Kill auf Remote Computern abrufen.You can view statistical data and process information for processes running on remote computers but you cannot call Start, CloseMainWindow, or Kill on remote computers.

Hinweis

Wenn der zugeordnete Prozess auf dem lokalen Computer ausgeführt wird, gibt diese Eigenschaft einen Zeitraum (".") für den Computernamen zurück.When the associated process is executing on the local machine, this property returns a period (".") for the machine name. Verwenden Sie die- Environment.MachineName Eigenschaft, um den richtigen Computernamen zu erhalten.You should use the Environment.MachineName property to get the correct machine name.

Gilt für:

Siehe auch