New-AzNetAppFilesBucket

Modul:
Az.NetAppFiles Module

Erstellt einen neuen Bucket auf einem Azure NetApp Files (ANF)-Volume.

Syntax

ByFieldsParameterSet (Standard) 

New-AzNetAppFilesBucket
    -ResourceGroupName <String>
    -AccountName <String>
    -PoolName <String>
    -VolumeName <String>
    -Name <String>
    [-Path <String>]
    [-Permissions <String>]
    [-NfsUserId <Int64>]
    [-NfsGroupId <Int64>]
    [-CifsUserName <String>]
    [-ServerFqdn <String>]
    [-ServerCertificateObject <String>]
    [-OnCertificateConflictAction <String>]
    [-CertificateKeyVaultUri <String>]
    [-CertificateName <String>]
    [-CredentialsKeyVaultUri <String>]
    [-CredentialsSecretName <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByParentObjectParameterSet 

New-AzNetAppFilesBucket
    -Name <String>
    -VolumeObject <PSNetAppFilesVolume>
    [-Path <String>]
    [-Permissions <String>]
    [-NfsUserId <Int64>]
    [-NfsGroupId <Int64>]
    [-CifsUserName <String>]
    [-ServerFqdn <String>]
    [-ServerCertificateObject <String>]
    [-OnCertificateConflictAction <String>]
    [-CertificateKeyVaultUri <String>]
    [-CertificateName <String>]
    [-CredentialsKeyVaultUri <String>]
    [-CredentialsSecretName <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzNetAppFilesBucket erstellt einen Bucket auf einem ANF-Volume. Buckets machen Volumedaten für externe Dienste verfügbar (z. B. AI-Dienste) über einen S3-kompatiblen Endpunkt und erfordern ein Zertifikat auf dem Bucketserver (bereitgestellt über ServerCertificateObject oder von Azure Key Vault über verwaltet über Azure Key Vault CertificateKeyVaultUri / CertificateName). Die Dateisystembenutzeridentität, die auf die Volumedaten zugreift, muss entweder über NfsUserId / NfsGroupId (NFS) oder CifsUserName (SMB) bereitgestellt werden.

Beispiele

Beispiel 1: Erstellen eines Buckets mit einem selbstsignierten Inlinezertifikat

$certObject = [System.Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes((Get-Content -Raw ./bucket.pem)))

New-AzNetAppFilesBucket -ResourceGroupName "MyRG" -AccountName "MyAnfAccount" -PoolName "MyAnfPool" -VolumeName "MyAnfVolume" -Name "MyAnfBucket" `
    -Path "/" -Permissions "ReadOnly" `
    -NfsUserId 1000 -NfsGroupId 1000 `
    -ServerFqdn "bucket.contoso.local" `
    -ServerCertificateObject $certObject `
    -OnCertificateConflictAction "Update"

Erstellt einen ReadOnly-Bucket, der den Volumestamm für einen NFS-Benutzer 1000:1000 verfügbar macht, wobei ein inline-PEM-codiertes Zertifikat+Schlüsselpaar verwendet wird. Wenn Sie "OnCertificateConflictAction " festlegen, kann Update der Bucketserver ein vorhandenes Zertifikat ohne Fehlschlagen wiederverwenden/aktualisieren.

Beispiel 2: Erstellen eines Buckets mit AKV-verwaltetem Zertifikat und Anmeldeinformationen

New-AzNetAppFilesBucket -ResourceGroupName "MyRG" -AccountName "MyAnfAccount" -PoolName "MyAnfPool" -VolumeName "MyAnfVolume" -Name "MyAnfBucket" `
    -Path "/data" -Permissions "ReadWrite" -CifsUserName "anfuser" `
    -ServerFqdn "bucket.contoso.local" -OnCertificateConflictAction "Update" `
    -CertificateKeyVaultUri "https://anf-bucket-certs.vault.azure.net/" -CertificateName "anf-bucket-cert" `
    -CredentialsKeyVaultUri "https://anf-bucket-creds.vault.azure.net/" -CredentialsSecretName "anf-bucket-creds"

Erstellt einen ReadWrite-Bucket, dessen Serverzertifikat aus Azure Key Vault abgerufen wird und dessen generiertes Zugriffs-/Geheimschlüsselpaar wieder in Azure Key Vault gespeichert wird.

Parameter

-AccountName

Der Name des ANF-Kontos

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CertificateKeyVaultUri

Basis-URI des Azure Key Vault zum Abrufen des Bucketserverzertifikats verwendet.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CertificateName

Name des Bucketserverzertifikats, das in Azure Key Vault gespeichert ist.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CifsUserName

CIFS-Benutzername, der auf die Bucketdaten zugreift (sich gegenseitig ausschließend mit NfsUserId/NfsGroupId).

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Cf

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CredentialsKeyVaultUri

Basis-URI der Azure Key Vault zum Speichern der Bucketanmeldeinformationen verwendet.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CredentialsSecretName

Der Name des geheimen Schlüssels in Azure Key Vault, in dem die Bucketanmeldeinformationen vorhanden sind.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Der Name des ANF-Buckets

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:BucketName

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-NfsGroupId

NFS-Benutzer-GID, die auf die Bucketdaten zugreifen.

Parametereigenschaften

Typ:

Nullable<T>[Int64]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-NfsUserId

NFS-Benutzer-UID, die auf die Bucketdaten zugreift (sich gegenseitig mit CifsUserName ausschließen).

Parametereigenschaften

Typ:

Nullable<T>[Int64]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-OnCertificateConflictAction

Aktion, wenn ein Zertifikatkonflikt auftritt. Aktualisieren oder fehlschlagen.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Path

Der Im Bucket bereitgestellte Volumepfad. Der Standardwert ist "/".

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Permissions

Zugriffsberechtigungen für den Bucket. Entweder ReadOnly oder ReadWrite. Standardwert ist "ReadOnly".

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PoolName

Der Name des ANF-Kapazitätspools

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

Die Ressourcengruppe des ANF-Kontos

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ServerCertificateObject

Base64-codierter Inhalt der PEM-Datei, die das Bucketserverzertifikat und den privaten Schlüssel enthält. Schließen Sie sich gegenseitig mit den AKV-Zertifikatparametern aus.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ServerFqdn

Hostteil der Bucket-URL, Auflösen in die Bucket-IP und zulässig durch das Serverzertifikat.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VolumeName

Der Name des ANF-Volumes

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByFieldsParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-VolumeObject

Das Volumeobjekt, das den neuen Bucket enthält

Parametereigenschaften

Typ:PSNetAppFilesVolume
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

ByParentObjectParameterSet
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

PSNetAppFilesVolume

Ausgaben

PSNetAppFilesBucket