New-AzNetAppFilesBucket

Modulo:
Az.NetAppFiles Module

Crea un nuovo bucket in un volume Azure NetApp Files (ANF).

Sintassi

ByFieldsParameterSet (Impostazione predefinita) 

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>]

Descrizione

Il cmdlet New-AzNetAppFilesBucket crea un bucket in un volume ANF. I bucket espongono i dati del volume a servizi esterni (ad esempio, Servizi di intelligenza artificiale) su un endpoint compatibile con S3 e richiedono un certificato nel server bucket (fornito inline tramite ServerCertificateObject o gestito da Azure Key Vault tramite CertificateKeyVaultUri / CertificateName). L'identità utente del file system che accede ai dati del volume deve essere fornita tramite NfsUserId / (NFS) o CifsUserName (SMB).

Esempio

Esempio 1: Creare un bucket con un certificato autofirmato inline

$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"

Crea un bucket ReadOnly che espone la radice del volume a un utente NFS 1000:1000, usando una coppia di certificati+chiave con codifica PEM inline. L'impostazione di OnCertificateConflictAction su Update consente al server bucket di riutilizzare/aggiornare un certificato esistente senza errori.

Esempio 2: Creare un bucket con certificato gestito da AKV e credenziali

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"

Crea un bucket ReadWrite il cui certificato server viene recuperato da Azure Key Vault e la cui coppia di chiavi di accesso/segreto generata verrà archiviata di nuovo in Azure Key Vault.

Parametri

-AccountName

Nome dell'account ANF

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByFieldsParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-CertificateKeyVaultUri

URI di base del Azure Key Vault usato per recuperare il certificato del server bucket.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-CertificateName

Nome del certificato del server bucket archiviato in Azure Key Vault.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-CifsUserName

Nome utente CIFS che accede ai dati del bucket (che si escludono a vicenda con NfsUserId/NfsGroupId).

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-CredentialsKeyVaultUri

URI di base del Azure Key Vault usato per archiviare le credenziali del bucket.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-CredentialsSecretName

Nome del segreto in Azure Key Vault che contiene le credenziali del bucket.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Name

Nome del bucket ANF

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:BucketName

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-NfsGroupId

GID utente NFS che accede ai dati del bucket.

Proprietà dei parametri

Tipo:

Nullable<T>[Int64]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-NfsUserId

UID utente NFS che accede ai dati del bucket (che si escludono a vicenda con CifsUserName).

Proprietà dei parametri

Tipo:

Nullable<T>[Int64]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-OnCertificateConflictAction

Azione quando si verifica un conflitto di certificati. Aggiornamento o esito negativo.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Path

Percorso del volume montato all'interno del bucket. Il valore predefinito è '/'.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Permissions

Autorizzazioni di accesso per il bucket. ReadOnly o ReadWrite. Il valore predefinito è ReadOnly.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PoolName

Nome del pool di capacità ANF

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByFieldsParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ResourceGroupName

Gruppo di risorse dell'account ANF

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByFieldsParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ServerCertificateObject

Contenuto con codifica Base64 del file PEM contenente il certificato del server bucket e la chiave privata. Si escludono a vicenda con i parametri del certificato AKV.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ServerFqdn

Ospitare parte dell'URL del bucket, risolvendo l'INDIRIZZO IP del bucket e consentito dal certificato del server.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-VolumeName

Nome del volume ANF

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByFieldsParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-VolumeObject

Oggetto volume contenente il nuovo bucket

Proprietà dei parametri

Tipo:PSNetAppFilesVolume
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ByParentObjectParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

PSNetAppFilesVolume

Output

PSNetAppFilesBucket