Udostępnij za pośrednictwem

Get-AzBatchRemoteDesktopProtocolFile

  • Odwołanie
Moduł:
Az.Batch

Pobiera plik RDP z węzła obliczeniowego.

Składnia

Get-AzBatchRemoteDesktopProtocolFile
   [-PoolId] <String>
   [-ComputeNodeId] <String>
   -DestinationPath <String>
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchRemoteDesktopProtocolFile
   [-PoolId] <String>
   [-ComputeNodeId] <String>
   -DestinationStream <Stream>
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchRemoteDesktopProtocolFile
   [[-ComputeNode] <PSComputeNode>]
   -DestinationPath <String>
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzBatchRemoteDesktopProtocolFile
   [[-ComputeNode] <PSComputeNode>]
   -DestinationStream <Stream>
   -BatchContext <BatchAccountContext>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-AzBatchRemoteDesktopProtocolFile pobiera plik protokołu RDP (Remote Desktop Protocol) z węzła obliczeniowego i zapisuje go jako plik lub strumień dostarczony przez użytkownika.

Przykłady

Przykład 1. Pobieranie pliku RDP z określonego węzła obliczeniowego i zapisywanie pliku

Get-AzBatchRemoteDesktopProtocolFile -PoolId "Pool06" -ComputeNodeId "ComputeNode01" -DestinationPath "C:\PowerShell\ComputeNode01.rdp" -BatchContext $Context

To polecenie pobiera plik RDP z węzła obliczeniowego, który ma identyfikator ComputeNode01 w puli, która ma identyfikator Pool06. Polecenie zapisuje plik rdp jako C:\PowerShell\MyComputeNode.rdp. Użyj polecenia cmdlet Get-AzBatchAccountKey, aby przypisać kontekst do zmiennej $Context.

Przykład 2. Pobieranie pliku RDP z węzła obliczeniowego i zapisywanie pliku przy użyciu potoku

Get-AzBatchComputeNode -PoolId "Pool06" -Id "ComputeNode02" -BatchContext $Context | Get-AzBatchRemoteDesktopProtocolFile -DestinationPath "C:\PowerShell\MyComputeNode02.rdp" -BatchContext $Context

To polecenie pobiera węzeł obliczeniowy o identyfikatorze ComputeNode02 w puli, która ma identyfikator Pool06. Polecenie przekazuje ten węzeł obliczeniowy do bieżącego polecenia cmdlet przy użyciu operatora potoku. Bieżące polecenie cmdlet pobiera plik rpd z węzła obliczeniowego, a następnie zapisuje zawartość jako plik o nazwie C:\PowerShell\MyComputeNode02.rdp.

Przykład 3. Pobieranie pliku RDP z określonego węzła obliczeniowego i kierowanie go do strumienia

$Stream = New-Object -TypeName "System.IO.MemoryStream"
Get-AzBatchRemoteDesktopProtocolFile "Pool06" -ComputeNodeId "ComputeNode03" -DestinationStream $Stream -BatchContext $Context

Pierwsze polecenie tworzy strumień przy użyciu polecenia cmdlet New-Object, a następnie zapisuje go w zmiennej $Stream. Drugie polecenie pobiera plik rdp z węzła obliczeniowego o identyfikatorze ComputeNode03 w puli z pulą identyfikatorów Puli06. Polecenie kieruje zawartość pliku do strumienia w $Stream.

Parametry

-BatchContext

Określa wystąpienie BatchAccountContext używane przez to polecenie cmdlet do interakcji z usługą Batch. Jeśli użyjesz polecenia cmdlet Get-AzBatchAccount w celu pobrania elementu BatchAccountContext, uwierzytelnianie Microsoft Entra będzie używane podczas interakcji z usługą Batch. Aby zamiast tego użyć uwierzytelniania klucza współużytkowanego, użyj polecenia cmdlet Get-AzBatchAccountKey, aby uzyskać obiekt BatchAccountContext z wypełnionymi kluczami dostępu. W przypadku korzystania z uwierzytelniania za pomocą klucza współużytkowanego klucz podstawowy jest używany domyślnie. Aby zmienić klucz do użycia, ustaw właściwość BatchAccountContext.KeyInUse.

Typ:BatchAccountContext
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ComputeNode

Określa węzeł obliczeniowy jako obiekt PSComputeNode, do którego wskazuje plik rdp. Aby uzyskać obiekt węzła obliczeniowego, użyj polecenia cmdlet Get-AzBatchComputeNode.

Typ:PSComputeNode
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ComputeNodeId

Określa identyfikator węzła obliczeniowego, do którego wskazuje plik rdp.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DestinationPath

Określa ścieżkę pliku, w której to polecenie cmdlet zapisuje plik rdp.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DestinationStream

Określa strumień, do którego to polecenie cmdlet kieruje dane protokołu RDP. To polecenie cmdlet nie zamyka ani nie przewija tego strumienia.

Typ:Stream
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PoolId

Określa identyfikator puli zawierającej węzeł obliczeniowy, z którego to polecenie cmdlet pobiera plik rdp.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

PSComputeNode

BatchAccountContext

Dane wyjściowe

Void