Set-AzureSubscription

Référence

Module:: Azure

Modifie un abonnement Azure.

Notes

Les cmdlets mentionnées dans cette documentation servent à gérer les ressources Azure héritées qui utilisent les API Gestion des services. Pour ce qui est des cmdlets permettant de gérer des ressources Azure Resource Manager, consultez le Module Az PowerShell.

Syntax

Set-AzureSubscription
   -SubscriptionId <String>
   [-Certificate <X509Certificate2>]
   [-ServiceEndpoint <String>]
   [-ResourceManagerEndpoint <String>]
   [-CurrentStorageAccountName <String>]
   [-Context <AzureStorageContext>]
   [-Environment <String>]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Set-AzureSubscription
   -SubscriptionName <String>
   [-Certificate <X509Certificate2>]
   [-ServiceEndpoint <String>]
   [-ResourceManagerEndpoint <String>]
   [-CurrentStorageAccountName <String>]
   [-Context <AzureStorageContext>]
   [-Environment <String>]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Set-AzureSubscription
   -SubscriptionName <String>
   -SubscriptionId <String>
   -Certificate <X509Certificate2>
   [-ServiceEndpoint <String>]
   [-ResourceManagerEndpoint <String>]
   [-CurrentStorageAccountName <String>]
   [-Context <AzureStorageContext>]
   [-Environment <String>]
   [-PassThru]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

L’applet de commande Set-AzureSubscription établit et modifie les propriétés d’un objet d’abonnement Azure. Vous pouvez utiliser cette applet de commande pour travailler dans un abonnement Azure qui n’est pas votre abonnement par défaut ou pour modifier votre compte de stockage actuel. Pour plus d’informations sur les abonnements actuels et par défaut, consultez l’applet de commande Select-AzureSubscription .

Cette applet de commande fonctionne sur un objet d’abonnement Azure, et non sur votre abonnement Azure réel. Pour créer et approvisionner un abonnement Azure, visitez le portail Azure (https://azure.microsoft.com/).

Cette applet de commande modifie les données du fichier de données d’abonnement que vous créez lorsque vous utilisez l’applet de commande Add-AzureAccount ou Import-AzurePublishSettingsFile pour ajouter un compte Azure à Windows PowerShell.

Cette rubrique décrit l’applet de commande dans la version 0.8.10 du module Microsoft Azure PowerShell. Pour obtenir la version du module que vous utilisez, dans la console Azure PowerShell, tapez (Get-Module -Name Azure).Version.

Exemples

Exemple 1 : Modifier un abonnement existant1

C:\PS> $thumbprint = <Thumbprint-2>
C:\PS> $differentCert = Get-Item cert:\\CurrentUser\My\$thumbprint
C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -Certificate $differentCert

Cet exemple montre comment modifier le certificat de l’abonnement nommé ContosoEngineering.

Exemple 2 : Modifier le point de terminaison de service

C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -ServiceEndpoint "https://management.core.contoso.com"

Cette commande ajoute ou modifie un point de terminaison de service personnalisé pour l’abonnement ContosoEngineering.

Exemple 3 : Effacer les valeurs de propriété

C:\PS> Set-AzureSubscription -SubscriptionName ContosoEngineering -Certificate $null -ResourceManagerEndpoint $Null

Cette commande définit les valeurs des propriétés Certificate et ResourceManagerEndpoint sur Null ($Null). Cela efface les valeurs de ces propriétés sans modifier d’autres paramètres.

Exemple 4 : Utiliser un autre fichier de données d’abonnement

C:\PS> Set-AzureSubscription -SubscriptionName ContosoFinance -SubscriptionDataFile C:\Azure\SubscriptionData.xml -CurrentStorageAccount ContosoStorage01

Cette commande modifie le compte de stockage actuel de l’abonnement ContosoFinance à ContosoStorage01. La commande utilise le paramètre SubscriptionDataFile pour modifier les données dans le fichier de données d’abonnement C:\Azure\SubscriptionData.xml. Par défaut, Set-AzureSubscription utilise le fichier de données d’abonnement par défaut dans votre profil utilisateur itinérant.

Paramètres

-Certificate

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

-Context

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

-CurrentStorageAccountName

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

-Environment

Spécifie un environnement Azure.

Un environnement Azure un déploiement indépendant de Microsoft Azure, tel qu’AzureCloud pour Azure global et AzureChinaCloud pour Azure géré par 21Vianet en Chine. Vous pouvez également créer des environnements Azure locaux à l’aide d’Azure Pack et des applets de commande WAPack. Pour plus d’informations, consultez Azure Pack.

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

-PassThru

Retourne $True si la commande réussit et $False en cas d’échec. Par défaut, cette applet de commande ne retourne aucune sortie.

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

-Profile

Spécifie le profil Azure à partir duquel cette applet de commande lit. Si vous ne spécifiez pas de profil, cette applet de commande lit le profil par défaut local.

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

-ResourceManagerEndpoint

Spécifie le point de terminaison pour les données Azure Resource Manager, y compris les données relatives aux groupes de ressources associés au compte. Pour plus d’informations sur Azure Resource Manager, consultez applets de commande Azure Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394765) et utilisation de Windows PowerShell avec Resource Manager (https://go.microsoft.com/fwlink/?LinkID=394767).

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

-ServiceEndpoint

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

-SubscriptionId

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

-SubscriptionName

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

Entrées

None

Vous pouvez diriger l’entrée vers cette applet de commande par nom de propriété, mais pas par valeur.

Sorties

None or System.Boolean

Lorsque vous utilisez le paramètre PassThru , cette applet de commande retourne une valeur booléenne. Par défaut, cette applet de commande ne retourne aucune sortie.