Udostępnij za pośrednictwem

Set-AzureStorageContainerAcl

  • Odwołanie
Moduł:
Azure.Storage

Ustawia uprawnienia dostępu publicznego do kontenera magazynu.

Ostrzeżenie

Moduł AzureRM PowerShell jest 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-AzureStorageContainerAcl
   [-Name] <String>
   [-Permission] <BlobContainerPublicAccessType>
   [-PassThru]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Set-AzureStorageContainerAcl ustawia uprawnienia dostępu publicznego do określonego kontenera magazynu na platformie Azure.

Przykłady

Przykład 1. Ustawianie listy ACL kontenera usługi Azure Storage według nazwy

PS C:\>Set-AzureStorageContainerAcl -Container "Container01" -Permission Off -PassThru

To polecenie tworzy kontener, który nie ma dostępu publicznego.

Przykład 2. Ustawianie listy ACL kontenera usługi Azure Storage przy użyciu potoku

PS C:\>Get-AzureStorageContainer container* | Set-AzureStorageContainerAcl -Permission Blob -PassThru

To polecenie pobiera wszystkie kontenery magazynu, których nazwa rozpoczyna się od kontenera, a następnie przekazuje wynik w potoku, aby ustawić uprawnienie dla nich wszystkich do dostępu do obiektów blob.

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.

Typ:Nullable<T>[Int32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:Nullable<T>[Int32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Context

Określa kontekst usługi Azure Storage. Można go utworzyć przy użyciu polecenia cmdlet New-AzureStorageContext.

Typ:IStorageContext
Position:Named
Domyślna wartość:None
Wymagane:False
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:AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę kontenera.

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

-PassThru

Zwraca obiekt reprezentujący element, z którym pracujesz. Domyślnie to polecenie cmdlet nie generuje żadnych danych wyjściowych.

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

-Permission

Określa poziom dostępu publicznego do tego kontenera. Domyślnie kontener i wszystkie w nim obiekty blob mogą być dostępne tylko przez właściciela konta magazynu. Aby przyznać anonimowym użytkownikom uprawnienia do odczytu do kontenera i jego obiektów blob, możesz ustawić uprawnienia kontenera, aby umożliwić dostęp publiczny. Użytkownicy anonimowi mogą odczytywać obiekty blob w publicznie dostępnym kontenerze bez uwierzytelniania żądania. Dopuszczalne wartości tego parametru to: --Container. Zapewnia pełny dostęp do odczytu do kontenera i jego obiektów blob. Klienci mogą wyliczać obiekty blob w kontenerze za pomocą żądania anonimowego, ale nie mogą wyliczać kontenerów na koncie magazynu. --Blob. Zapewnia dostęp do odczytu do danych obiektów blob w kontenerze za pośrednictwem żądania anonimowego, ale nie zapewnia dostępu do danych kontenera. Klienci nie mogą wyliczać obiektów blob w kontenerze przy użyciu żądania anonimowego. --Od. Ogranicza dostęp tylko do właściciela konta magazynu.

Typ:BlobContainerPublicAccessType
Aliasy:PublicAccess
Dopuszczalne wartości:Off, Container, Blob, Unknown
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ServerTimeoutPerRequest

Określa interwał limitu czasu po stronie usługi w sekundach dla żądania. Jeśli określony interwał upłynie, zanim usługa przetworzy żądanie, usługa magazynu zwróci błąd. Limit czasu po stronie serwera dla każdego żądania.

Typ:Nullable<T>[Int32]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

IStorageContext

Dane wyjściowe

AzureStorageContainer