Set-AzureStorageFileContent

Moduł:

Azure.Storage

Przekazuje zawartość pliku.

Ostrzeżenie

Moduł AzureRM PowerShell został oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

Set-AzureStorageFileContent
   [-ShareName] <String>
   [-Source] <String>
   [[-Path] <String>]
   [-PassThru]
   [-Force]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureStorageFileContent
   [-Share] <CloudFileShare>
   [-Source] <String>
   [[-Path] <String>]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureStorageFileContent
   [-Directory] <CloudFileDirectory>
   [-Source] <String>
   [[-Path] <String>]
   [-PassThru]
   [-Force]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

Polecenie cmdlet Set-AzureStorageFileContent przekazuje zawartość pliku do pliku w określonym udziale.

Przykłady

Przykład 1. Przekazywanie pliku w bieżącym folderze

PS C:\>Set-AzureStorageFileContent -ShareName "ContosoShare06" -Source "DataFile37" -Path "ContosoWorkingFolder/CurrentDataFile"

To polecenie przekazuje plik o nazwie DataFile37 w bieżącym folderze jako plik o nazwie CurrentDataFile w folderze o nazwie ContosoWorkingFolder.

Przykład 2. Przekazywanie wszystkich plików w bieżącym folderze

PS C:\>$CurrentFolder = (Get-Item .).FullName
PS C:\> $Container = Get-AzureStorageShare -Name "ContosoShare06"
PS C:\> Get-ChildItem -Recurse | Where-Object { $_.GetType().Name -eq "FileInfo"} | ForEach-Object {
    $path=$_.FullName.Substring($Currentfolder.Length+1).Replace("\","/")
    Set-AzureStorageFileContent -Share $Container -Source $_.FullName -Path $path -Force
}

W tym przykładzie użyto kilku typowych poleceń cmdlet programu Windows PowerShell i bieżącego polecenia cmdlet, aby przekazać wszystkie pliki z bieżącego folderu do folderu głównego kontenera ContosoShare06. Pierwsze polecenie pobiera nazwę bieżącego folderu i zapisuje je w zmiennej $CurrentFolder. Drugie polecenie używa polecenia cmdlet Get-AzureStorageShare , aby uzyskać udział plików o nazwie ContosoShare06, a następnie zapisuje go w zmiennej $Container. Ostatnie polecenie pobiera zawartość bieżącego folderu i przekazuje każdy z nich do polecenia cmdlet Where-Object przy użyciu operatora potoku. To polecenie cmdlet filtruje obiekty, które nie są plikami, a następnie przekazuje pliki do polecenia cmdlet ForEach-Object. To polecenie cmdlet uruchamia blok skryptu dla każdego pliku, który tworzy odpowiednią ścieżkę, a następnie używa bieżącego polecenia cmdlet do przekazania pliku. Wynik ma taką samą nazwę i taką samą pozycję względną w odniesieniu do innych plików, które ten przykład przekazuje. Aby uzyskać więcej informacji na temat bloków skryptów, wpisz Get-Help about_Script_Blocks.

Parametry

-ClientTimeoutPerRequest

Określa interwał limitu czasu po stronie klienta w sekundach dla jednego żądania obsługi. Jeśli poprzednie wywołanie zakończy się niepowodzeniem w określonym interwale, to polecenie cmdlet ponawia próbę żądania. Jeśli to polecenie cmdlet nie otrzyma pomyślnej odpowiedzi przed upływem interwału, to polecenie cmdlet zwróci błąd.

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConcurrentTaskCount

Określa maksymalne współbieżne wywołania sieciowe. Tego parametru można użyć, aby ograniczyć współbieżność w celu ograniczenia użycia lokalnego procesora CPU i przepustowości, określając maksymalną liczbę współbieżnych wywołań sieciowych. Określona wartość jest liczbą bezwzględną i nie jest mnożona przez liczbę rdzeni. Ten parametr może pomóc w zmniejszeniu problemów z połączeniem sieciowym w środowiskach o niskiej przepustowości, takich jak 100 kilobitów na sekundę. Wartość domyślna to 10.

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Context

Określa kontekst usługi Azure Storage. Aby uzyskać kontekst magazynu, użyj polecenia cmdlet New-AzureStorageContext .

Type:	IStorageContext
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Directory

Określa folder jako obiekt CloudFileDirectory . To polecenie cmdlet przekazuje plik do folderu, który określa ten parametr. Aby uzyskać katalog, użyj polecenia cmdlet New-AzureStorageDirectory. Aby uzyskać katalog, możesz również użyć polecenia cmdlet Get-AzureStorageFile.

Type:	CloudFileDirectory
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Force

Wskazuje, że to polecenie cmdlet zastępuje istniejący plik usługi Azure Storage.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Wskazuje, że to polecenie cmdlet zwraca obiekt AzureStorageFile , który tworzy lub przekazuje.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

Określa ścieżkę pliku lub folderu. To polecenie cmdlet przekazuje zawartość do pliku, który określa ten parametr, lub do pliku w folderze, który określa ten parametr. Jeśli określisz folder, to polecenie cmdlet utworzy plik o takiej samej nazwie jak plik źródłowy. Jeśli określisz ścieżkę pliku, który nie istnieje, to polecenie cmdlet utworzy ten plik i zapisze zawartość w tym pliku. Jeśli określisz plik, który już istnieje i określisz parametr Force , to polecenie cmdlet zastępuje zawartość pliku. Jeśli określisz plik, który już istnieje i nie określisz wartości Force, to polecenie cmdlet nie spowoduje zmiany i zwróci błąd. Jeśli określisz ścieżkę folderu, który nie istnieje, to polecenie cmdlet nie spowoduje zmiany i zwróci błąd.

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ServerTimeoutPerRequest

Określa długość limitu czasu dla części żądania serwera.

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Share

Określa obiekt CloudFileShare . To polecenie cmdlet przekazuje do pliku w udziale plików, który określa ten parametr. Aby uzyskać obiekt CloudFileShare , użyj polecenia cmdlet Get-AzureStorageShare. Ten obiekt zawiera kontekst magazynu. Jeśli określisz ten parametr, nie określ parametru Context .

Type:	CloudFileShare
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ShareName

Określa nazwę udziału plików. To polecenie cmdlet przekazuje do pliku w udziale plików, który określa ten parametr.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Source

Określa plik źródłowy przekazywany przez to polecenie cmdlet. Jeśli określisz plik, który nie istnieje, to polecenie cmdlet zwróci błąd.

Type:	String
Aliases:	FullName
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Dane wejściowe

CloudFileShare

Parametry: Udostępnianie (ByValue)

CloudFileDirectory

Parametry: Katalog (ByValue)

String

IStorageContext

Dane wyjściowe

CloudFile

Linki powiązane

• Remove-AzureStorageDirectory
• New-AzureStorageDirectory
• Get-AzureStorageFileContent