Freigeben über

Set-AzureStorageContainerAcl

  • Referenz
Modul:
Azure.Storage

Legt die Berechtigung für den öffentlichen Zugriff auf einen Speichercontainer fest.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

Set-AzureStorageContainerAcl
   [-Name] <String>
   [-Permission] <BlobContainerPublicAccessType>
   [-PassThru]
   [-Context <IStorageContext>]
   [-ServerTimeoutPerRequest <Int32>]
   [-ClientTimeoutPerRequest <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-ConcurrentTaskCount <Int32>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-AzureStorageContainerAcl legt die Berechtigung für den öffentlichen Zugriff auf den angegebenen Speichercontainer in Azure fest.

Beispiele

Beispiel 1: Festlegen der Azure Storage Container-ACL anhand des Namens

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

Mit diesem Befehl wird ein Container erstellt, der keinen öffentlichen Zugriff hat.

Beispiel 2: Festlegen der Azure-Speichercontainer-ACL mithilfe der Pipeline

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

Dieser Befehl ruft alle Speichercontainer ab, deren Name mit container beginnt, und übergibt dann das Ergebnis für die Pipeline, um die Berechtigung für sie alle auf Blob-Zugriff festzulegen.

Parameter

-ClientTimeoutPerRequest

Gibt das clientseitige Timeoutintervall in Sekunden für eine Serviceanfrage an. Wenn der vorherige Aufruf im angegebenen Intervall fehlschlägt, führt dieses Cmdlet die Anforderung erneut aus. Wenn dieses Cmdlet vor Ablauf des Intervalls keine erfolgreiche Antwort erhält, gibt dieses Cmdlet einen Fehler zurück.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ConcurrentTaskCount

Gibt die maximalen gleichzeitigen Netzwerkanrufe an. Mit diesem Parameter können Sie die Parallelität einschränken, um die lokale CPU- und Bandbreitenauslastung zu drosseln, indem Sie die maximale Anzahl gleichzeitiger Netzwerkanrufe angeben. Der angegebene Wert ist eine absolute Anzahl und wird nicht mit der Kernanzahl multipliziert. Dieser Parameter kann dazu beitragen, Netzwerkverbindungsprobleme in Umgebungen mit geringer Bandbreite zu reduzieren, z. B. 100 Kilobit pro Sekunde. Der Standardwert ist 10.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Context

Gibt den Azure-Speicherkontext an. Sie können es mithilfe des Cmdlets New-AzureStorageContext erstellen.

Typ:IStorageContext
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt einen Containernamen an.

Typ:String
Aliase:N, Container
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Permission

Gibt die Ebene des öffentlichen Zugriffs auf diesen Container an. Standardmäßig kann auf den Container und alle darin enthaltenen Blobs nur vom Besitzer des Speicherkontos zugegriffen werden. Um anonymen Benutzern Leseberechtigungen für einen Container und seine Blobs zu gewähren, können Sie die Containerberechtigungen so festlegen, dass der öffentliche Zugriff aktiviert wird. Anonyme Benutzer können Blobs in einem öffentlich verfügbaren Container lesen, ohne die Anforderung zu authentifizieren. Die zulässigen Werte für diesen Parameter sind: --Container. Bietet volllesezugriff auf einen Container und seine Blobs. Clients können Blobs im Container über anonyme Anforderung aufzählen, container jedoch nicht im Speicherkonto aufzählen. --Blob. Bietet Lesezugriff auf BLOB-Daten in einem Container über anonyme Anforderung, bietet jedoch keinen Zugriff auf Containerdaten. Clients können Blobs im Container nicht mithilfe einer anonymen Anforderung aufzählen. --Aus. Beschränkt den Zugriff nur auf den Besitzer des Speicherkontos.

Typ:BlobContainerPublicAccessType
Aliase:PublicAccess
Zulässige Werte:Off, Container, Blob, Unknown
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServerTimeoutPerRequest

Gibt das Dienstseitige Timeoutintervall in Sekunden für eine Anforderung an. Wenn das angegebene Intervall verstrichen ist, bevor der Dienst die Anforderung verarbeitet, gibt der Speicherdienst einen Fehler zurück. Serverseitiges Timeout für jede Anforderung.

Typ:Nullable<T>[Int32]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

IStorageContext

Ausgaben

AzureStorageContainer