Set-AzContext
Beállítja a parancsmagok bérlői, előfizetési és környezeti beállításait az aktuális munkamenetben való használatra.
Syntax
Context (Alapértelmezett)
Set-AzContext
[-Context] <PSAzureContext>
[-ExtendedProperty <System.Collections.Generic.IDictionary`2[System.String,System.String]>]
[-Name <String>]
[-Force]
[-Scope <ContextModificationScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
TenantObject
Set-AzContext
[-TenantObject] <PSAzureTenant>
[-ExtendedProperty <System.Collections.Generic.IDictionary`2[System.String,System.String]>]
[-Name <String>]
[-Force]
[-Scope <ContextModificationScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SubscriptionObject
Set-AzContext
[-SubscriptionObject] <PSAzureSubscription>
[-ExtendedProperty <System.Collections.Generic.IDictionary`2[System.String,System.String]>]
[-Name <String>]
[-Force]
[-Scope <ContextModificationScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Subscription
Set-AzContext
[-Subscription] <String>
[-Tenant <String>]
[-ExtendedProperty <System.Collections.Generic.IDictionary`2[System.String,System.String]>]
[-Name <String>]
[-Force]
[-Scope <ContextModificationScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
TenantNameOnly
Set-AzContext
-Tenant <String>
[-ExtendedProperty <System.Collections.Generic.IDictionary`2[System.String,System.String]>]
[-Name <String>]
[-Force]
[-Scope <ContextModificationScope>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
A Set-AzContext parancsmag beállítja az aktuális munkamenetben futtatott parancsmagok hitelesítési adatait.
A környezet tartalmazza a bérlői, előfizetési és környezeti információkat.
Példák
1. példa: Az előfizetési környezet beállítása
Set-AzContext -Subscription "xxxx-xxxx-xxxx-xxxx"
Name Account SubscriptionName Environment TenantId
---- ------- ---------------- ----------- --------
Work test@outlook.com Subscription1 AzureCloud xxxxxxxx-x...
Ez a parancs beállítja a környezetet a megadott előfizetés használatára.
Paraméterek
-Confirm
Megerősítést kér a parancsmag futtatása előtt.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: False
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: Cf
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-Context
Az aktuális munkamenet környezetét adja meg.
Paramétertulajdonságok
Típus: PSAzureContext
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
Context
Position: 0
Kötelező: True
Folyamatból származó érték: True
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, bérlő és előfizetés.
Paramétertulajdonságok
Típus: IAzureContextContainer
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: AzContext, AzureRmContext, AzureCredential
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-ExtendedProperty
További környezeti tulajdonságok
Paramétertulajdonságok
Típus: IDictionary<TKey,TValue> [ System.String,System.String ]
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-Force
Írja felül a meglévő környezetet ugyanazzal a névvel, ha van ilyen.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-Name
A környezet neve
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-Scope
Meghatározza a környezeti változások hatókörét, például azt, hogy a módosítások csak az aktuális folyamatra vagy a felhasználó által indított összes munkamenetre vonatkoznak-e.
Paramétertulajdonságok
Típus: ContextModificationScope
Alapértelmezett érték: None
Elfogadott értékek: Process, CurrentUser
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-Subscription
Annak az előfizetésnek a neve vagy azonosítója, amelyet a környezetnek be kell állítania. Ez a paraméter -SubscriptionName és -SubscriptionId aliasokkal rendelkezik, így az egyértelműség kedvéért ezek közül bármelyik használható a -Subscription helyett a név és az azonosító megadásakor.
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: Előfizetési azonosító, Előfizetés neve
Paraméterkészletek
Subscription
Position: 0
Kötelező: True
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-SubscriptionObject
Előfizetési objektum
Paramétertulajdonságok
Típus: PSAzureSubscription
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
SubscriptionObject
Position: 0
Kötelező: True
Folyamatból származó érték: True
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-Tenant
Bérlő tartományneve vagy azonosítója
Paramétertulajdonságok
Típus: String
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: Szakterület, BérlőAzonosító (TenantId)
Paraméterkészletek
Subscription
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-TenantObject
Bérlőobjektum
Paramétertulajdonságok
Típus: PSAzureTenant
Alapértelmezett érték: None
Támogatja a helyettesítő karaktereket: False
DontShow: False
Paraméterkészletek
TenantObject
Position: 0
Kötelező: True
Folyamatból származó érték: True
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
-WhatIf
Megjeleníti, mi történne, ha a parancsmag futna. A parancsmag nem fut.
Paramétertulajdonságok
Típus: SwitchParameter
Alapértelmezett érték: False
Támogatja a helyettesítő karaktereket: False
DontShow: False
Aliasok: Wi
Paraméterkészletek
(All)
Position: Named
Kötelező: False
Folyamatból származó érték: False
Folyamatból származó érték tulajdonságnév alapján: False
Fennmaradó argumentumokból származó érték: False
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters .
Kimenetek