Get-AzBatchNodeFile
Pobiera właściwości plików węzłów usługi Batch.
Składnia
Get-AzBatchNodeFile
[-PoolId] <String>
[-ComputeNodeId] <String>
[[-Path] <String>]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzBatchNodeFile
-JobId <String>
-TaskId <String>
[[-Path] <String>]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzBatchNodeFile
-JobId <String>
-TaskId <String>
[-Filter <String>]
[-MaxCount <Int32>]
[-Recursive]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzBatchNodeFile
[[-Task] <PSCloudTask>]
[-Filter <String>]
[-MaxCount <Int32>]
[-Recursive]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzBatchNodeFile
[-PoolId] <String>
[-ComputeNodeId] <String>
[-Filter <String>]
[-MaxCount <Int32>]
[-Recursive]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Get-AzBatchNodeFile
[[-ComputeNode] <PSComputeNode>]
[-Filter <String>]
[-MaxCount <Int32>]
[-Recursive]
-BatchContext <BatchAccountContext>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Opis
Polecenie cmdlet Get-AzBatchNodeFile pobiera właściwości plików węzłów usługi Azure Batch zadania lub węzła obliczeniowego. Aby zawęzić wyniki, możesz określić filtr Open Data Protocol (OData). Jeśli określisz zadanie, ale nie filtr, to polecenie cmdlet zwróci właściwości dla wszystkich plików węzłów dla tego zadania. Jeśli określisz węzeł obliczeniowy, ale nie filtr, to polecenie cmdlet zwróci właściwości wszystkich plików węzłów dla tego węzła obliczeniowego.
Przykłady
Przykład 1. Pobieranie właściwości pliku węzła skojarzonego z zadaniem
Get-AzBatchNodeFile -JobId "Job-000001" -TaskId "Task26" -Path "Stdout.txt" -BatchContext $Context
IsDirectory Name Properties Url
----------- ---- ---------- ---
False StdOut.txt Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...
To polecenie pobiera właściwości pliku węzła StdOut.txt skojarzonego z zadaniem o identyfikatorze Task26 w zadaniu o identyfikatorze Job-000001. Użyj polecenia cmdlet Get-AzBatchAccountKey, aby przypisać kontekst do zmiennej $Context.
Przykład 2. Pobieranie właściwości plików węzłów skojarzonych z zadaniem przy użyciu filtru
Get-AzBatchNodeFile -JobId "Job-00002" -TaskId "Task26" -Filter "startswith(name,'St')" -BatchContext $Context
IsDirectory Name Properties Url
----------- ---- ---------- ---
False StdErr.txt Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...
False StdOut.txt Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...
To polecenie pobiera właściwości plików węzłów, których nazwy zaczynają się od st i są skojarzone z zadaniem o identyfikatorze Task26 w obszarze zadania, które ma identyfikator Job-00002.
Przykład 3. Rekursywnie pobiera właściwości plików węzłów skojarzonych z zadaniem
Get-AzBatchTask "Job-00003" "Task31" -BatchContext $Context | Get-AzBatchNodeFile -Recursive -BatchContext $Context
IsDirectory Name Properties Url
----------- ---- ---------- ---
False ProcessEnv.cmd Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...
False StdErr.txt Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...
False StdOut.txt Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...
True wd https://cmdletexample.westus.Batch.contoso...
False wd\newFile.txt Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...
To polecenie pobiera właściwości wszystkich plików skojarzonych z zadaniem o identyfikatorze Task31 w zadaniu Job-00003. To polecenie określa parametr rekursywny. W związku z tym polecenie cmdlet wykonuje cykliczne wyszukiwanie plików i zwraca plik węzła wd\newFile.txt.
Przykład 4. Pobieranie pojedynczego pliku z węzła obliczeniowego
Get-AzBatchNodeFile -PoolId "Pool22" -ComputeNodeId "ComputeNode01" -Path "Startup\StdOut.txt" -BatchContext $Context
IsDirectory Name Properties Url
----------- ---- ---------- ---
False startup\stdout.txt Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...
To polecenie pobiera plik o nazwie Startup\StdOut.txt z węzła obliczeniowego o identyfikatorze ComputeNode01 w puli z pulą identyfikatorów 22.
Przykład 5. Pobieranie wszystkich plików w folderze z węzła obliczeniowego
Get-AzBatchNodeFile -PoolId "Pool22" -ComputeNodeId "ComputeNode01" -Filter "startswith(name,'startup')" -Recursive -BatchContext $Context
IsDirectory Name Properties Url
----------- ---- ---------- ---
True startup https://cmdletexample.westus.Batch.contoso...
False startup\ProcessEnv.cmd Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...
False startup\stderr.txt Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...
False startup\stdout.txt Microsoft.Azure.Commands.Batch.Models.PSFile... https://cmdletexample.westus.Batch.contoso...
True startup\wd https://cmdletexample.westus.Batch.contoso...
To polecenie pobiera wszystkie pliki w folderze uruchamiania z węzła obliczeniowego o identyfikatorze ComputeNode01 w puli, która ma pulę identyfikatorów 22. To polecenie cmdlet określa parametr rekursywny.
Przykład 6. Pobieranie plików z folderu głównego węzła obliczeniowego
Get-AzBatchComputeNode "Pool22" -Id "ComputeNode01" -BatchContext $Context | Get-AzBatchNodeFile -BatchContext $Context
IsDirectory Name Properties Url
----------- ---- ---------- ---
True shared https://cmdletexample.westus.Batch.contoso...
True startup https://cmdletexample.westus.Batch.contoso...
True workitems https://cmdletexample.westus.Batch.contoso...
To polecenie pobiera wszystkie pliki w folderze głównym węzła obliczeniowego o identyfikatorze ComputeNode01 w puli zawierającej pulę identyfikatorów Pool22.
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, który zawiera pliki węzłów usługi Batch. 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, który zawiera pliki węzła usługi Batch.
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 |
-Filter
Określa klauzulę filtru OData. To polecenie cmdlet zwraca właściwości dla plików węzłów, które są zgodne z filtrem, który określa ten parametr.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-JobId
Określa identyfikator zadania zawierającego zadanie docelowe.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-MaxCount
Określa maksymalną liczbę plików węzłów, dla których to polecenie cmdlet zwraca właściwości. Jeśli określisz wartość zero (0) lub mniejszą, polecenie cmdlet nie używa górnego limitu. Wartość domyślna to 1000.
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Path
Określa ścieżkę pliku węzła, dla którego to polecenie cmdlet pobiera właściwości. Nie można określić symboli wieloznacznych.
Typ: | String |
Aliasy: | Name |
Position: | 2 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-PoolId
Określa identyfikator puli zawierającej węzeł obliczeniowy, z którego mają być uzyskiwane właściwości plików węzłów.
Typ: | String |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-Recursive
Wskazuje, że to polecenie cmdlet zwraca cykliczną listę plików. W przeciwnym razie zwraca tylko pliki w folderze głównym.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Task
Określa zadanie jako obiekt PSCloudTask, z którym są skojarzone pliki węzłów. Aby uzyskać obiekt zadania, użyj polecenia cmdlet Get-AzBatchTask.
Typ: | PSCloudTask |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-TaskId
Określa identyfikator zadania, dla którego to polecenie cmdlet pobiera właściwości plików węzłów.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |